Chamar a API com curl

Chamar a API com curl

Depois de ler este guia, você poderá fazer uma chamada de chat via linha de comando com curl. Nossa API é compatível com OpenAI — para a documentação completa de parâmetros, consulte a referência da API OpenAI.

Requisição

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": "Você é um assistente útil"},
      {"role": "user", "content": "Olá"}
    ]
  }'

Três substituições:

  1. sk-xxxxxxxx → sua API Key
  2. your-model-name → um nome de modelo copiado do catálogo de modelos
  3. Olá → a mensagem que você quer enviar

Resposta

Um JSON é retornado normalmente; a resposta do modelo está em choices[0].message.content.

Parâmetros comuns

  • temperature: aleatoriedade — 0 é o mais estável, 1 o mais criativo
  • max_tokens: limita o tamanho máximo da resposta
  • stream: defina como true para saída em streaming — a resposta chega progressivamente

Solução de problemas

  • 401: Key incorreta — ver Códigos de erro.
  • 429: muitas requisições — tente novamente mais tarde.
  • Sem resposta por muito tempo: verifique a rede e confirme se a Base URL é https://api.tvtapi.com/v1.