`POST /v1/conversations`

Usa los campos de solicitud y permisos documentados para este endpoint HTTP.

Ejemplo de solicitud#

curl -X POST 'https://platform.tongai.io/v1/conversations' \  -H "Authorization: Bearer $TONG_API_KEY" \  -H "Content-Type: application/json" \  -H "Idempotency-Key: 45be69f1-c266-4a09-a82c-bf3c6303eb03" \  -d '{  "entrypoint": "assistant",  "mode": "guided"}'

Configuración

curl --version

Autenticación#

Usa una clave API en tu servidor para tu cuenta, u OAuth para la cuenta de cada cliente. Nunca envíes claves en instrucciones ni argumentos.

assistant:runcredits:spend

Parámetros#

Idempotency-KeystringObligatorio

Un UUID, por ejemplo e8aa0a87-6cd9-42eb-975a-b72bf43218c8.

Cuerpo de solicitud#

application/json

entrypointstringObligatorio

Valores permitidos"assistant""filmmaker"

modestringObligatorio

Las ejecuciones guiadas esperan revisión humana en Tong. Las automáticas continúan. Ambas cobran según avanzan y se pausan sin créditos.

Valores permitidos"guided""automatic"

titlestringOpcional

Longitud máxima: 100 caracteres.

project_idstringOpcional

Un ID hexadecimal de 24 caracteres.

model_preferencesobjectOpcional

Mostrar campos anidados

imagestring | nullObligatorio

Usa letras, números, guiones bajos, puntos, dos puntos, barras o guiones.

Longitud mínima: 1 caracteres.

Longitud máxima: 150 caracteres.

videostring | nullObligatorio

Usa letras, números, guiones bajos, puntos, dos puntos, barras o guiones.

Longitud mínima: 1 caracteres.

Longitud máxima: 150 caracteres.

sourceobjectOpcional

Mostrar campos anidados

kindstringObligatorio

Valores permitidos"director""text"

idstringObligatorio

Un ID hexadecimal de 24 caracteres.

Esquema de respuesta#

Respuesta

JSON

{}

`HTTP 201`

application/json

object

Errores y límites#

HTTP	Error	Recuperación
`400`	Solicitud no válida`REQUEST_INVALID`	Corrige los campos indicados por el error antes de reintentar.
`401`	Credencial no válida`CREDENTIAL_INVALID`	Comprueba la credencial, su vencimiento y si fue revocada.
`402`	Créditos insuficientes`INSUFFICIENT_CREDITS`	Añade créditos a la cuenta de la credencial y continúa el trabajo guardado.
`403`	Permiso denegado`SCOPE_REQUIRED`	Usa una credencial con los permisos necesarios y acceso al recurso seleccionado.
`404`	Recurso no disponible`RESOURCE_UNAVAILABLE`	Comprueba el ID del recurso y que pertenezca a la cuenta autorizada.
`409`	Conflicto de intención`IDEMPOTENCY_CONFLICT`	Reutiliza una intención solo con su solicitud original. Usa un nuevo UUID para otra acción.
`429`	Límite de solicitudes alcanzado`RATE_LIMITED`	Espera el intervalo de Retry-After antes de reintentar la misma solicitud.
`503`	No disponible temporalmente`DEPENDENCY_UNAVAILABLE`	Espera Retry-After y reintenta con la misma intención. Consulta la operación guardada tras un tiempo de espera.

AutenticaciónLas claves API cobran a la cuenta propietaria. OAuth permite a cada usuario conectado usar sus créditos.Errores y límites de solicitudesComprende los errores, reintenta de forma segura y recupera generaciones fallidas.Solicitudes y registrosUna solicitud aceptada no es una generación terminada. Sigue el trabajo hasta que el resultado esté listo.