L’API di rendering AI Graydient
Se stai costruendo un’app, uno strumento interno o una pipeline di rendering, Graydient ti offre modelli open di immagini, video e LLM su GPU dedicate, dietro un’unica API, a prezzo mensile fisso.
Quale piano la include
L'API personale è inclusa solo con Video Max. Images e Video Plus non includono accesso API. Puoi fare upgrade, downgrade o cancellare in qualsiasi momento nel portale di fatturazione, con addebiti proporzionati. Prezzi del piano Business e API su business.graydient.ai.
L'API personale è una chiave per un singolo utente umano, e il traffico automatizzato non è consentito su nessun piano personale. Ciò significa niente bot, script, scheduler, batch job, scraper, app multiutente o accesso rivenduto. Ha un limite di frequenza: mantieni circa una chiamata ogni 10 secondi. Le chiavi che inviano traffico automatizzato o eccessivo vengono revocate senza preavviso.
Costruire un prodotto multi-utente o white-label
Utenti virtuali e login white-label sono funzionalità business per app distribuite, cioè prodotti con molti utenti. Funzionano sull’API personale, quindi puoi costruire e testare flussi multi-utente e white-label su Video Max durante lo sviluppo.
Andare in produzione con un prodotto multiutente, traffico automatizzato o accesso rivenduto richiede il piano Business: un server GPU dedicato. business.graydient.ai spiega cosa è incluso, elenca i prezzi e lo vende.
| API personale (Video Max) | Distribuzione business | |
|---|---|---|
| Utenti | Un utente (tu) | Gli utenti del tuo prodotto |
| Rivendita | Non consentita | Consentita |
| Utenti virtuali e login white-label | Costruisci e testa | Vai in produzione |
| Come ottenerlo | Abbonati a Video Max | Server GPU dedicato o accordo commerciale |
Come funziona l'API
La versione attuale è la V3, su https://cloud.graydient.ai/api/v3/. Segue la specifica JSON:API: invia e accetta application/vnd.api+json, autentica con un token Bearer HTTP standard dalla tua pagina dei token API e leggi i risultati da un oggetto data con un membro attributes.
Il rendering è asincrono. Invia un POST a POST /api/v3/render/ con un prompt e un callback_url obbligatorio. Graydient risponde subito con un render_hash più i tempi stimati di attesa e rendering. Quando il lavoro termina, invia i risultati al tuo webhook. I campi opzionali includono:
- error_url: un webhook per i fallimenti
- init_image e mask_image: per image-to-image e inpainting
- placeholders: URL di immagini nominati per modalità ControlNet o adattatori IP
- progressive_return: un callback per ogni immagine
- session_id: collega i render ai tuoi utenti
I workflow passano dallo stesso endpoint con un comando workflow nel prompt.
Stato senza polling: GET GET /api/v3/render/{render_hash} restituisce lo stato di un render, ma la documentazione consiglia di non fare polling. Usa il webhook o lo stream WebSocket su wss://cloud.graydient.ai/render-events/{render_hash}, che invia eventi started, image_done, done ed error.
Altre famiglie di endpoint
- Chat: chat LLM con una persona. Le risposte vanno a un callback o tornano inline con sync: true, e i modelli vision accettano un image_url.
- Concepts: elenca modelli e LoRA disponibili.
- Workflows: elenca i workflow e cosa supportano, come txt2img, img2img, txt2vid e img2vid.
- Knowledge base: crea un dominio, aggiungi fatti, esplora URL, poi cerca o chatta.
- Skills: trasforma richieste in linguaggio naturale in comandi workflow.
- Utenti virtuali: mappa i tuoi utenti finali a record sul tuo account. Costruisci e testa con l'API personale, poi vai in produzione con un deployment business.
Riferimento completo: documentazione API. La documentazione dice che è ancora in sviluppo.
Casi d'uso tipici
- Alimenta la tua app: usa Graydient come backend di rendering per immagini, video o chat. Sviluppa con l'API personale, poi passa a un deployment business quando arrivano utenti reali.
- Usa i tuoi modelli ospitati: rendi con LoRA e checkpoint installati. Vedi ospita i tuoi modelli AI.
- Esecuzione remota di workflow in stile ComfyAPI: chiama i workflow mappati dal tuo codice.
- Immagini di prodotto e catalogo: ingrandisci, modifica o cambia stile delle immagini da una pipeline, entro il limite di velocità dell'API personale.
- Rendering batch: per batch sostenuti e ad alto volume, usa un server GPU dedicato invece dell'API personale.
- Chat knowledge-base: costruisci un assistente supporto o documentazione sugli endpoint knowledge base e chat.
Server GPU dedicati
Se prevedi di eseguire traffico automatizzato, un prodotto multiutente, accesso API rivenduto o rendering batch tutto il giorno, ti serve il piano Business: un server GPU dedicato, con la tua macchina e senza coda condivisa. Prezzi, cosa è incluso e modulo d'ordine su business.graydient.ai.
Il prezzo per rendering su server dedicato, video incluso, è elencato su business.graydient.ai. Quel prezzo per rendering si applica solo al piano Business. Images, Video Plus e Video Max rimangono a tariffa fissa senza costi per rendering.
Il traffico automatizzato non è consentito sui piani personali. Images, Video Plus e Video Max sono piani a tariffa fissa per un singolo utente umano, e le chiavi che inviano traffico automatizzato vengono revocate.
Per iniziare
- Abbonati a Video Max. Puoi cambiare o annullare il piano in qualsiasi momento nel portale di fatturazione.
- Crea un token nella tua pagina dei token API.
- Leggi la documentazione API e cerca su GitHub esempi d'uso dell'API Graydient.
- Configura un endpoint webhook, poi invia la tua prima richiesta di rendering.
- Duplica e crea miniature delle immagini risultanti prima di servirle ai tuoi utenti, come raccomandato dalla documentazione.
Il supporto API è disponibile via email a info@graydient.ai. Tutto l'uso è soggetto al politica di uso accettabile e ai termini di utilizzo.