API Hop

Documentação

Documentação do API Hop

Catálogo de modelos

Liste os modelos disponíveis para a chave de API atual e seus protocolos públicos.

GEThttps://api.apihop.ai/v1/models

GET https://api.apihop.ai/v1/models retorna os modelos disponíveis para a chave de API atual. A disponibilidade pode mudar conforme a configuração dos modelos, a saúde do serviço e as permissões da chave; portanto, a resposta da API em tempo real é a fonte definitiva.

O Claude Sonnet 4.6 (claude-sonnet-4-6) é suportado pelo fornecedor, mas não está publicado atualmente na RequestBeam. Não é o padrão de uma integração ativa. Antes de chamar qualquer modelo, confirme o acesso com sua própria resposta de GET https://api.apihop.ai/v1/models.

text
GET https://api.apihop.ai/v1/models

Autenticação

Todas as requisições exigem um token Bearer.

http
Authorization: Bearer YOUR_API_KEY

Exemplo de requisição

bash
curl --request GET \
  --url https://api.apihop.ai/v1/models \
  --header 'Authorization: Bearer YOUR_API_KEY'

Resposta

uidstring

Identificador público do modelo. Em APIs que aceitam model, use este valor no campo model do corpo da requisição.

namestring

Nome de exibição.

versionstring | null

Campo de versão. As entradas atuais geralmente retornam null.

typestring

Tipo de modelo, atualmente principalmente text, image ou video.

pricingobject | null

Preço atual da plataforma para o modelo. Consulte a API em tempo real ou o console para valores atuais.

Exemplo de sucesso

json
{
  "success": true,
  "data": [
    {
      "uid": "gpt-5.6-sol",
      "name": "ChatGPT-5.6 Sol",
      "version": null,
      "type": "text",
      "pricing": {
        "unit": "credits",
        "tokenTierBasis": "input_tokens",
        "tiers": []
      }
    },
    {
      "uid": "seedance-2.5",
      "name": "Seedance 2.5",
      "version": null,
      "type": "video",
      "pricing": {
        "unit": "credits",
        "tiers": []
      }
    }
  ],
  "requestId": "req_..."
}

Modelos de texto atuais

A tabela abaixo resume os modelos de texto documentados atualmente. Em cada requisição, use os modelos retornados pela sua própria chamada a GET https://api.apihop.ai/v1/models.

Família de modelosID do modeloChat CompletionsResponsesClaude Messages
OpenAIgpt-5.4SimSim-
OpenAIgpt-5.5SimSim-
OpenAIgpt-5.6-solSimSim-
OpenAIgpt-5.6-terraSimSim-
OpenAIgpt-6-astraSimSim-
Anthropicclaude-fable-5Sim-Sim
Anthropicclaude-fable-5-1Sim-Sim
Anthropicclaude-opus-4-6Sim-Sim
Anthropicclaude-opus-4-7Sim-Sim
Anthropicclaude-opus-4-8Sim-Sim
Anthropicclaude-opus-5Sim-Sim
Anthropicclaude-opus-5-5Sim-Sim
Anthropicclaude-sonnet-5Sim-Sim
Anthropicclaude-sonnet-5-5Sim-Sim
DeepSeekdeepseek-v4-flashSim--
DeepSeekdeepseek-v4-proSim--
DeepSeekdeepseek-v4.1-flashApós implantação e ativação--
Geminigemini-3.6-flashSim--
Geminigemini-3.7-flashSim--
Geminigemini-3.8-flashSim--
Geminigemini-3.5-flash-liteSim--
Geminigemini-4-argonSim (após ativação)--
Kimikimi-k3Sim--
MiniMaxminimax-m3Sim--

O orçamento de saída do Claude inclui raciocínio e texto final. Um valor pequeno de max_tokens, como 128, pode se esgotar antes da produção de qualquer texto final. Use um orçamento inteiro positivo com espaço para ambos, como descrito em Mensagens Claude.

Guias das famílias de modelos

  • Modelos DeepSeek: deepseek-v4-flash, deepseek-v4-pro, deepseek-v4.1-flash (ID distinto, disponível somente após implantação e ativação; consulte GET https://api.apihop.ai/v1/models)
  • Modelos Gemini: gemini-3.6-flash, gemini-3.7-flash, gemini-3.8-flash, gemini-3.5-flash-lite, gemini-4-argon (após implantação e ativação)
  • Modelo Kimi: kimi-k3
  • Modelo MiniMax: minimax-m3

Esses guias cobrem seleção de modelos, exemplos de requisição, notas sobre orçamento de saída e os limites atuais dos protocolos públicos. A resposta em tempo real deste endpoint continua sendo a referência para disponibilidade.

Modelos de imagem e vídeo atuais

Família de modelosID do modeloTipoEndpoint público
OpenAIgpt-image-2ImagemPOST https://api.apihop.ai/openai/v1/images/generations
OpenAIgpt-image-2.5-flareImagemPOST https://api.apihop.ai/openai/v1/images/generations
OpenAIgpt-image-2.5-sunburstImagemPOST https://api.apihop.ai/openai/v1/images/generations
BytePlusseedance-2.0VídeoPOST https://api.apihop.ai/v1/video/seedance
BytePlusseedance-2.5VídeoPOST https://api.apihop.ai/v1/video/seedance

Outra entrada de API

twitterapi representa as APIs de dados do Twitter e não é um modelo de chat. Use os endpoints /v1/twitter/* em vez de enviar twitterapi ao Chat Completions.

Regras dos IDs de modelos

  • As APIs Chat Completions, Responses, Claude Messages, de imagem e de vídeo Seedance usam model.
  • Os IDs canônicos dos modelos Seedance são seedance-2.0 e seedance-2.5. O endpoint Seedance 2.0 também aceita o alias antigo seedance-2-0, mas novas requisições e consultas ao catálogo devem usar o ID canônico com ponto.
  • Use somente IDs retornados por GET https://api.apihop.ai/v1/models.
  • Modelos indisponíveis não aparecem em /v1/models e não devem ser usados em novas chamadas.
  • Uma chave de API com restrições de modelos pode receber apenas um subconjunto dos modelos documentados.

Resposta de erro

Consulte Códigos de erro e solução de problemas para a referência completa, diferenças de protocolo e etapas de diagnóstico.

json
{
  "success": false,
  "error": {
    "code": 20000,
    "message": "Invalid or missing API key"
  },
  "requestId": "req_..."
}