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.
https://api.apihop.ai/v1/modelsGET 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.
GET https://api.apihop.ai/v1/modelsAutenticação
Todas as requisições exigem um token Bearer.
Authorization: Bearer YOUR_API_KEYExemplo de requisição
curl --request GET \
--url https://api.apihop.ai/v1/models \
--header 'Authorization: Bearer YOUR_API_KEY'Resposta
uidstringIdentificador público do modelo. Em APIs que aceitam model, use este valor no campo model do corpo da requisição.
namestringNome de exibição.
versionstring | nullCampo de versão. As entradas atuais geralmente retornam null.
typestringTipo de modelo, atualmente principalmente text, image ou video.
pricingobject | nullPreço atual da plataforma para o modelo. Consulte a API em tempo real ou o console para valores atuais.
Exemplo de sucesso
{
"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 modelos | ID do modelo | Chat Completions | Responses | Claude Messages |
|---|---|---|---|---|
| OpenAI | gpt-5.4 | Sim | Sim | - |
| OpenAI | gpt-5.5 | Sim | Sim | - |
| OpenAI | gpt-5.6-sol | Sim | Sim | - |
| OpenAI | gpt-5.6-terra | Sim | Sim | - |
| OpenAI | gpt-6-astra | Sim | Sim | - |
| Anthropic | claude-fable-5 | Sim | - | Sim |
| Anthropic | claude-fable-5-1 | Sim | - | Sim |
| Anthropic | claude-opus-4-6 | Sim | - | Sim |
| Anthropic | claude-opus-4-7 | Sim | - | Sim |
| Anthropic | claude-opus-4-8 | Sim | - | Sim |
| Anthropic | claude-opus-5 | Sim | - | Sim |
| Anthropic | claude-opus-5-5 | Sim | - | Sim |
| Anthropic | claude-sonnet-5 | Sim | - | Sim |
| Anthropic | claude-sonnet-5-5 | Sim | - | Sim |
| DeepSeek | deepseek-v4-flash | Sim | - | - |
| DeepSeek | deepseek-v4-pro | Sim | - | - |
| DeepSeek | deepseek-v4.1-flash | Após implantação e ativação | - | - |
| Gemini | gemini-3.6-flash | Sim | - | - |
| Gemini | gemini-3.7-flash | Sim | - | - |
| Gemini | gemini-3.8-flash | Sim | - | - |
| Gemini | gemini-3.5-flash-lite | Sim | - | - |
| Gemini | gemini-4-argon | Sim (após ativação) | - | - |
| Kimi | kimi-k3 | Sim | - | - |
| MiniMax | minimax-m3 | Sim | - | - |
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; consulteGET 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 modelos | ID do modelo | Tipo | Endpoint público |
|---|---|---|---|
| OpenAI | gpt-image-2 | Imagem | POST https://api.apihop.ai/openai/v1/images/generations |
| OpenAI | gpt-image-2.5-flare | Imagem | POST https://api.apihop.ai/openai/v1/images/generations |
| OpenAI | gpt-image-2.5-sunburst | Imagem | POST https://api.apihop.ai/openai/v1/images/generations |
| BytePlus | seedance-2.0 | Vídeo | POST https://api.apihop.ai/v1/video/seedance |
| BytePlus | seedance-2.5 | Vídeo | POST 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.0eseedance-2.5. O endpoint Seedance 2.0 também aceita o alias antigoseedance-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/modelse 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.
Documentação relacionada
- Conclusões de chat comuns
- Modelos DeepSeek
- Modelos Gemini
- Modelo Kimi
- Modelo MiniMax
- Respostas OpenAI
- Mensagens Claude
- Geração de imagens GPT-Image-2
- Geração de vídeo Seedance 2.0
- Geração de vídeo Seedance 2.5
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.
{
"success": false,
"error": {
"code": 20000,
"message": "Invalid or missing API key"
},
"requestId": "req_..."
}