Processo di richiesta
Per utilizzare l’API SeeDream Images Generation, prima vai al Pannello di controllo di Ace Data Cloud per ottenere il tuo API Token, da conservare per uso futuro.
Se non hai ancora effettuato il login o la registrazione, verrai automaticamente reindirizzato alla pagina di login che ti invita a registrarti e accedere; una volta completato, verrai riportato automaticamente alla pagina corrente.
Un API Token è sufficiente per accedere a tutti i servizi della piattaforma, senza necessità di richiederne uno per ogni servizio. La prima richiesta ti darà un credito gratuito, per un’esperienza senza costi; quando il credito è insufficiente, puoi ricaricare il saldo generale nel pannello di controllo.
📘 Documentazione completa: API SeeDream Images Generation →
Esempio di richiesta
L’API SeeDream Tasks può essere utilizzata per interrogare i risultati dell’API SeeDream Images Generation. Per informazioni su come utilizzare l’API SeeDream Images Generation, consulta la documentazione API SeeDream Images Generation. Prendiamo come esempio un ID attività restituito dal servizio API SeeDream Images Generation, per dimostrare come utilizzare questa API. Supponiamo di avere un ID attività: 20068983-0cc9-4c6a-aeb6-9c6a3c668be0, e ora dimostreremo come passare un ID attività.Esempio di attività
Impostazione dell’intestazione della richiesta e del corpo della richiesta
Request Headers includono:accept: specifica di ricevere la risposta in formato JSON, qui si compila conapplication/json.authorization: la chiave per chiamare l’API, che può essere selezionata direttamente dopo la richiesta.
id: l’ID dell’attività caricata.action: il modo di operare sull’attività.
Esempio di codice
Si può notare che sul lato destro della pagina sono già stati generati automaticamente vari codici in diverse lingue, come mostrato nell’immagine:
CURL
Esempio di risposta
Dopo una richiesta riuscita, l’API restituirà le informazioni dettagliate di questa attività. Ad esempio:success, lo stato attuale dell’attività di generazione video.task_id, l’ID dell’attività di generazione video attuale.trace_id, l’ID di tracciamento dell’attività video attuale.data, l’elenco dei risultati dell’attività di generazione immagini attuale.image_url, il link all’attività di generazione immagini attuale.prompt, la parola chiave.size: i pixel dell’immagine generata.
Operazione di query in batch
Questa è per interrogare i dettagli di più ID attività; a differenza di quanto sopra, è necessario selezionare l’azione come retrieve_batch. Request Body include:ids: un array di ID attività caricati.action: il modo di operare sull’attività.
Esempio di codice
Alcuni esempi di codice sono i seguenti:Esempio di risposta
Dopo una richiesta riuscita, l’API restituirà le informazioni dettagliate di tutte le attività in batch. Ad esempio:items include i dettagli specifici delle attività in batch, ogni attività ha informazioni specifiche e i campi sono gli stessi di quelli sopra.
items, tutti i dettagli specifici delle attività in batch. È un array, ogni elemento dell’array ha lo stesso formato del risultato della query di un’attività singola.count, il numero di attività in questa query batch.
created_at, data di creazione dell’attività, timestamp Unix (secondi, float).started_at, data di inizio esecuzione dell’attività, timestamp Unix (secondi, float).finished_at, data di completamento dell’attività, timestamp Unix (secondi, float). Questo campo non viene restituito se l’attività non è completata.elapsed, tempo di esecuzione dell’attività, unità in secondi (float, con 3 cifre decimali). Questo campo non viene restituito se l’attività non è completata.
CURL
Gestione degli errori
Quando si chiama l’API, se si verifica un errore, l’API restituirà il codice di errore e le informazioni corrispondenti. Ad esempio:400 token_mismatched: Richiesta non valida, probabilmente a causa di parametri mancanti o non validi.400 api_not_implemented: Richiesta non valida, probabilmente a causa di parametri mancanti o non validi.401 invalid_token: Non autorizzato, token di autorizzazione non valido o mancante.429 too_many_requests: Troppe richieste, hai superato il limite di frequenza.500 api_error: Errore interno del server, qualcosa è andato storto sul server.