Llamar a la API con curl

Llamar a la API con curl

Después de leer esta guía, podrás hacer una llamada de chat desde la línea de comandos con curl. Nuestra API es compatible con OpenAI — para la documentación completa de parámetros, consulta la referencia de la API de OpenAI.

Solicitud

curl https://api.tvtapi.com/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model-name",
    "messages": [
      {"role": "system", "content": "Eres un asistente útil"},
      {"role": "user", "content": "Hola"}
    ]
  }'

Tres sustituciones:

  1. sk-xxxxxxxx → tu API Key
  2. your-model-name → un nombre de modelo copiado del catálogo de modelos
  3. Hola → el mensaje que quieres enviar

Respuesta

Se devuelve un JSON normal; la respuesta del modelo está en choices[0].message.content.

Parámetros comunes

  • temperature: aleatoriedad — 0 es el más estable, 1 el más creativo
  • max_tokens: limita la longitud máxima de la respuesta
  • stream: ponlo en true para salida en streaming — la respuesta llega poco a poco

Solución de problemas

  • 401: Key incorrecta — ver Códigos de error.
  • 429: demasiadas solicitudes — reintenta más tarde.
  • Sin respuesta durante mucho tiempo: comprueba la red y confirma que la Base URL sea https://api.tvtapi.com/v1.