API Hop

Documentazione

Documentazione API Hop

Catalogo dei modelli

Elenca i modelli disponibili per la chiave API corrente e i relativi protocolli pubblici.

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

GET 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.

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

Autenticazione

Tutte le richieste richiedono un token Bearer.

http
Authorization: Bearer YOUR_API_KEY

Esempio di richiesta

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

Risposta

uidstring

Identificatore pubblico del modello. Per le API che accettano model, usa questo valore nel campo model del corpo della richiesta.

namestring

Nome visualizzato.

versionstring | null

Campo versione. Le voci attuali restituiscono generalmente null.

typestring

Tipo di modello, attualmente soprattutto text, image o video.

pricingobject | null

Prezzi attuali della piattaforma per il modello. Consulta l’API in tempo reale o la console per i valori correnti.

Esempio di successo

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_..."
}

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 modelliID del modelloChat CompletionsResponsesClaude Messages
OpenAIgpt-5.4SìSì-
OpenAIgpt-5.5SìSì-
OpenAIgpt-5.6-solSìSì-
OpenAIgpt-5.6-terraSìSì-
OpenAIgpt-6-astraSìSì-
Anthropicclaude-fable-5Sì-Sì
Anthropicclaude-fable-5-1Sì-Sì
Anthropicclaude-opus-4-6Sì-Sì
Anthropicclaude-opus-4-7Sì-Sì
Anthropicclaude-opus-4-8Sì-Sì
Anthropicclaude-opus-5Sì-Sì
Anthropicclaude-opus-5-5Sì-Sì
Anthropicclaude-sonnet-5Sì-Sì
Anthropicclaude-sonnet-5-5Sì-Sì
DeepSeekdeepseek-v4-flashSì--
DeepSeekdeepseek-v4-proSì--
DeepSeekdeepseek-v4.1-flashDopo distribuzione e attivazione--
Geminigemini-3.6-flashSì--
Geminigemini-3.7-flashSì--
Geminigemini-3.8-flashSì--
Geminigemini-3.5-flash-liteSì--
Geminigemini-4-argonSì (dopo attivazione)--
Kimikimi-k3Sì--
MiniMaxminimax-m3Sì--

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; controlla GET 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 modelliID del modelloTipoEndpoint pubblico
OpenAIgpt-image-2ImmaginePOST https://api.apihop.ai/openai/v1/images/generations
OpenAIgpt-image-2.5-flareImmaginePOST https://api.apihop.ai/openai/v1/images/generations
OpenAIgpt-image-2.5-sunburstImmaginePOST https://api.apihop.ai/openai/v1/images/generations
BytePlusseedance-2.0VideoPOST https://api.apihop.ai/v1/video/seedance
BytePlusseedance-2.5VideoPOST 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.0 e seedance-2.5. L’endpoint Seedance 2.0 accetta anche l’alias precedente seedance-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/models e non devono essere usati per nuove chiamate.
  • Una chiave API con restrizioni sui modelli può ricevere solo un sottoinsieme dei modelli documentati.

Risposta di errore

Consulta Codici di errore e risoluzione dei problemi per il riferimento completo, le differenze tra protocolli e i passaggi diagnostici.

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