Documentazione API Hop
Catalogo dei modelli
Elenca i modelli disponibili per la chiave API corrente e i relativi protocolli pubblici.
https://api.apihop.ai/v1/modelsGET https://api.apihop.ai/v1/models restituisce i modelli disponibili per la chiave API corrente. La disponibilità può cambiare in base alla configurazione dei modelli, allo stato del servizio e ai permessi della chiave API; la risposta API in tempo reale è quindi la fonte definitiva.
Claude Sonnet 4.6 (claude-sonnet-4-6) è supportato dal fornitore a monte, ma non è attualmente pubblicato su RequestBeam. Non è il modello predefinito di un’integrazione attiva. Prima di chiamare qualsiasi modello, verifica l’accesso con la tua risposta di GET https://api.apihop.ai/v1/models.
GET https://api.apihop.ai/v1/modelsAutenticazione
Tutte le richieste richiedono un token Bearer.
Authorization: Bearer YOUR_API_KEYEsempio di richiesta
curl --request GET \
--url https://api.apihop.ai/v1/models \
--header 'Authorization: Bearer YOUR_API_KEY'Risposta
uidstringIdentificatore pubblico del modello. Per le API che accettano model, usa questo valore nel campo model del corpo della richiesta.
namestringNome visualizzato.
versionstring | nullCampo versione. Le voci attuali restituiscono generalmente null.
typestringTipo di modello, attualmente soprattutto text, image o video.
pricingobject | nullPrezzi attuali della piattaforma per il modello. Consulta l’API in tempo reale o la console per i valori correnti.
Esempio di successo
{
"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_..."
}Modelli di testo attuali
La tabella seguente riepiloga i modelli di testo attualmente documentati. Per ogni richiesta usa i modelli restituiti dalla tua chiamata a GET https://api.apihop.ai/v1/models.
| Famiglia di modelli | ID del modello | Chat Completions | Responses | Claude Messages |
|---|---|---|---|---|
| OpenAI | gpt-5.4 | Sì | Sì | - |
| OpenAI | gpt-5.5 | Sì | Sì | - |
| OpenAI | gpt-5.6-sol | Sì | Sì | - |
| OpenAI | gpt-5.6-terra | Sì | Sì | - |
| OpenAI | gpt-6-astra | Sì | Sì | - |
| Anthropic | claude-fable-5 | Sì | - | Sì |
| Anthropic | claude-fable-5-1 | Sì | - | Sì |
| Anthropic | claude-opus-4-6 | Sì | - | Sì |
| Anthropic | claude-opus-4-7 | Sì | - | Sì |
| Anthropic | claude-opus-4-8 | Sì | - | Sì |
| Anthropic | claude-opus-5 | Sì | - | Sì |
| Anthropic | claude-opus-5-5 | Sì | - | Sì |
| Anthropic | claude-sonnet-5 | Sì | - | Sì |
| Anthropic | claude-sonnet-5-5 | Sì | - | Sì |
| DeepSeek | deepseek-v4-flash | Sì | - | - |
| DeepSeek | deepseek-v4-pro | Sì | - | - |
| DeepSeek | deepseek-v4.1-flash | Dopo distribuzione e attivazione | - | - |
| Gemini | gemini-3.6-flash | Sì | - | - |
| Gemini | gemini-3.7-flash | Sì | - | - |
| Gemini | gemini-3.8-flash | Sì | - | - |
| Gemini | gemini-3.5-flash-lite | Sì | - | - |
| Gemini | gemini-4-argon | Sì (dopo attivazione) | - | - |
| Kimi | kimi-k3 | Sì | - | - |
| MiniMax | minimax-m3 | Sì | - | - |
Il budget di output di Claude include ragionamento e testo finale. Un valore ridotto di max_tokens, come 128, può esaurirsi prima che venga prodotto testo finale. Usa un budget intero positivo con spazio per entrambi, come descritto in Messaggi Claude.
Guide alle famiglie di modelli
- Modelli DeepSeek:
deepseek-v4-flash,deepseek-v4-pro,deepseek-v4.1-flash(un ID distinto, disponibile solo dopo distribuzione e attivazione; controllaGET https://api.apihop.ai/v1/models) - Modelli Gemini:
gemini-3.6-flash,gemini-3.7-flash,gemini-3.8-flash,gemini-3.5-flash-lite,gemini-4-argon(dopo distribuzione e attivazione) - Modello Kimi:
kimi-k3 - Modello MiniMax:
minimax-m3
Queste guide trattano selezione dei modelli, esempi di richiesta, note sul budget di output e limiti degli attuali protocolli pubblici. La risposta in tempo reale di questo endpoint resta il riferimento per la disponibilità.
Modelli di immagini e video attuali
| Famiglia di modelli | ID del modello | Tipo | Endpoint pubblico |
|---|---|---|---|
| OpenAI | gpt-image-2 | Immagine | POST https://api.apihop.ai/openai/v1/images/generations |
| OpenAI | gpt-image-2.5-flare | Immagine | POST https://api.apihop.ai/openai/v1/images/generations |
| OpenAI | gpt-image-2.5-sunburst | Immagine | POST https://api.apihop.ai/openai/v1/images/generations |
| BytePlus | seedance-2.0 | Video | POST https://api.apihop.ai/v1/video/seedance |
| BytePlus | seedance-2.5 | Video | POST https://api.apihop.ai/v1/video/seedance |
Altra voce API
twitterapi rappresenta le API dati di Twitter e non è un modello di chat. Usa gli endpoint /v1/twitter/* invece di passare twitterapi a Chat Completions.
Regole degli ID dei modelli
- Le API Chat Completions, Responses, Claude Messages, immagini e video Seedance usano
model. - Gli ID canonici dei modelli Seedance sono
seedance-2.0eseedance-2.5. L’endpoint Seedance 2.0 accetta anche l’alias precedenteseedance-2-0, ma le nuove richieste e le ricerche nel catalogo devono usare l’ID canonico con il punto. - Usa solo ID restituiti da
GET https://api.apihop.ai/v1/models. - I modelli non disponibili non compaiono in
/v1/modelse non devono essere usati per nuove chiamate. - Una chiave API con restrizioni sui modelli può ricevere solo un sottoinsieme dei modelli documentati.
Documentazione correlata
- Completamenti chat comuni
- Modelli DeepSeek
- Modelli Gemini
- Modello Kimi
- Modello MiniMax
- Risposte OpenAI
- Messaggi Claude
- Generazione di immagini GPT-Image-2
- Generazione video Seedance 2.0
- Generazione video Seedance 2.5
Risposta di errore
Consulta Codici di errore e risoluzione dei problemi per il riferimento completo, le differenze tra protocolli e i passaggi diagnostici.
{
"success": false,
"error": {
"code": 20000,
"message": "Invalid or missing API key"
},
"requestId": "req_..."
}