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: $84 al mese con fatturazione annuale ($999 fatturati annualmente) o $99.99 mensili. Images e Video Plus non includono accesso API. Puoi aggiornare, retrocedere o cancellare in qualsiasi momento nel portale di fatturazione, con addebiti proporzionati.
L’API personale è una chiave per un utente e non è rivendibile. Ha limiti di velocità: mantieni circa una chiamata ogni 10 secondi ed evita il batching. Le chiavi possono scadere automaticamente se si inviano troppe richieste.
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 live con un prodotto multi-utente o rivendere accesso richiede l’opzione business: un server GPU dedicato o un accordo commerciale. Per discutere una distribuzione business, scrivi a info@graydient.ai.
| 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 vuoi gestire un prodotto multi-utente, rivendere accesso API o rendering batch tutto il giorno, Graydient offre un server GPU Video Max dedicato a $499.99 al mese. Hai la tua macchina senza coda, puoi eseguire lavori più lunghi e impostare limiti su cosa possono fare i tuoi clienti e quanto durano i loro slot in coda. Puoi aggiungere più server man mano che cresci, e il contratto richiede un preavviso di 30 giorni, senza impegno a lungo termine.
Prezzi di rendering su server dedicati: i rendering su server dedicato costano $0.02 ciascuno, video inclusi. Questo prezzo per render si applica solo al server dedicato. I piani Images, Video Plus e Video Max restano a tariffa fissa, senza costi per render.
Per noleggiarne uno, scrivi a info@graydient.ai.
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.