Vai al contenuto principale

Integrazioni

Integra modelli di immagine, video e modelli linguistici selezionati con un’unica API coerente.

Usa chiamate compatibili con OpenAI per chat e roleplay, oppure l’API delle attività per immagini, video e audio. Scegli un modello, conserva la chiave sul server e segui il percorso adatto al risultato che vuoi.

Scegli la tua strada

Una chiave API, quattro modi per collegarti

Parti da dove lavori già. Ogni strada porta agli stessi modelli, agli stessi prezzi.

Guida rapida in 5 minuti

La tua prima immagine in quattro passaggi

Crea un’attività, conserva il suo ID, poi recupera il file finito. Lo stesso schema vale per ogni modello di immagini, video e audio.

  1. 01

    Scegli un modello

    Confronta l’attività, gli input accettati, le regole sui contenuti, la disponibilità attuale e il prezzo.

  2. 02

    Copia una richiesta funzionante

    Sostituisci l’ID del modello e l’input di esempio con i campi esatti indicati nella pagina di quel modello. Non tirare mai a indovinare i parametri partendo da un altro modello.

  3. 03

    Invia dal tuo server

    HTTP 202 significa che l’attività è stata accettata, non che la generazione è finita; il codice applicativo dentro la struttura della risposta resta code: 200. Conserva subito data.taskId; estimatedCost è l’importo bloccato per questa attività.

  4. 04

    Interroga lo stato con un numero limitato di tentativi

    queued e running sono ancora in corso; succeeded, failed ed expired sono finali. Smetti di interrogare a qualsiasi stato finale, invece di aspettare solo il successo.

curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-8814-render-1" \
  -d '{
    "model": "alibaba/z-image-turbo/text-to-image",
    "input": { "prompt": "A ceramic teapot on a linen cloth, soft window light" }
  }'

alibaba/z-image-turbo/text-to-image è un endpoint reale da testo a immagine. Per un altro modello multimediale, usa il suo ID esatto e il suo schema.

Elenco

Tutte le integrazioni in un posto solo

Scegli lo strumento che usi già. Ogni scheda apre la sua guida alla configurazione.

Sicurezza lato server

Tre cose di cui la produzione deve occuparsi

Queste tre regole coprono una chiave trapelata, un addebito duplicato e un’attività persa. Sono il minimo prima di andare in produzione.

Tieni la chiave API sul server

Non esporre mai una chiave SpicyAPI nel codice del browser, in un bundle mobile, in un prompt, nei log o in un output visibile a un agent. Invia le richieste da un backend che controlli tu.

Idempotency-Key

Invia una Idempotency-Key stabile a ogni richiesta di creazione. Quando l’esito di rete è incerto, ripeti la stessa unità di lavoro con la stessa chiave: così non ti ritrovi mai con due attività fatturabili.

Segui le attività multimediali accettate

Salva il taskId restituito e usa un webhook firmato oppure controlli di stato con un limite. Un’attività accettata parte e non può essere annullata. Le attività fallite o scadute di norma non vengono addebitate. Alcuni modelli addebitano i rifiuti dei contenuti come indicato nella loro pagina; verifica queste condizioni prima dell’invio.

Documentazione API

Trova il riferimento per la tua domanda