Saltar para o conteúdo principal
Sunra oferece três endpoints de API para LLM, cada um seguindo um formato diferente. Os três utilizam a mesma autenticação e URL base (https://api-llm.sunra.ai), então você pode escolher o formato que melhor se encaixa no seu stack. Antes de começar, obtenha uma chave de API no seu painel de controle.

​
Chat Completions — /v1/chat/completions

O endpoint de Chat Completions segue o formato de OpenAI Chat Completions. Ele aceita uma lista de mensagens com roles (system, user, assistant) e retorna uma resposta gerada. Use este endpoint quando quiser compatibilidade direta com os SDKs e ferramentas da OpenAI. Principais recursos: streaming, chamadas de função, visão (imagens, áudio, vídeo, arquivos), raciocínio, saídas estruturadas (JSON schema / gramática), logprobs. 
curl -X POST https://api-llm.sunra.ai/v1/chat/completions \
  -H "Authorization: Bearer <SUNRA_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o",
    "messages": [
      { "role": "system", "content": "You are a helpful assistant." },
      { "role": "user", "content": "What is the capital of France?" }
    ]
  }'

​
Anthropic Messages — /v1/messages

O endpoint de Anthropic Messages segue o formato da API Anthropic Messages. Ele usa roles de mensagem user / assistant com blocos de conteúdo enriquecido e um parâmetro system separado. Use este endpoint quando quiser acesso nativo aos modelos Anthropic Claude e recursos como pensamento estendido, cache de prompts, citações e ferramentas integradas (busca web, execução de código). Principais recursos: streaming, pensamento estendido, cache de prompts, uso de ferramentas (personalizadas + integradas), entrada de PDF/documentos, citações, saídas estruturadas. 
curl -X POST https://api-llm.sunra.ai/v1/messages \
  -H "Authorization: Bearer <SUNRA_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "messages": [
      { "role": "user", "content": "Hello, how are you?" }
    ]
  }'

​
Responses — /v1/responses

O endpoint de Responses segue o formato da API OpenAI Responses. Ele aceita itens de entrada flexíveis (mensagens, chamadas de função, raciocínio) e retorna itens de saída estruturados. Use este endpoint quando precisar dos recursos mais recentes da OpenAI Responses, como busca web integrada, busca de arquivos, interpretador de código, uso de computador, integração de ferramentas MCP ou geração de imagens. Principais recursos: streaming, chamadas de função, busca web, busca de arquivos, interpretador de código, uso de computador, ferramentas MCP, geração de imagens, raciocínio, saídas estruturadas. 
curl -X POST https://api-llm.sunra.ai/v1/responses \
  -H "Authorization: Bearer <SUNRA_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o",
    "input": [
      { "type": "message", "role": "user", "content": "Hello, how are you?" }
    ]
  }'

​
Como escolher o endpoint certo

Chat CompletionsAnthropic MessagesResponses
FormatoOpenAI ChatAnthropic MessagesOpenAI Responses
Ideal paraCompatibilidade com SDK da OpenAIRecursos nativos do ClaudeRecursos mais recentes da OpenAI
StreamingSSESSESSE
Chamadas de funçãoSimSim (personalizadas + integradas)Sim
RaciocínioSimPensamento estendidoSim
Saída estruturadaJSON schema, gramáticaJSON schemaJSON schema
Ferramentas integradas—Busca web, execução de códigoBusca web, busca de arquivos, interpretador de código, uso de computador, MCP
Os três endpoints compartilham a mesma autenticação — basta passar sua chave de API como token Bearer no cabeçalho Authorization.