Ansökningsprocess
För att använda SeeDream Images Generation API, börja med att gå till Ace Data Cloud-konsolen för att få din API-token, som du kan spara för framtida bruk.
Om du inte har loggat in eller registrerat dig, kommer du automatiskt att omdirigeras till inloggningssidan där du uppmanas att registrera dig och logga in, och efter att ha slutfört detta kommer du automatiskt att återvända till den aktuella sidan.
En API-token räcker för att anropa alla tjänster på plattformen, du behöver inte ansöka separat för varje tjänst. Första ansökan ger en gratis kvot, så att du kan prova gratis; när kvoten är otillräcklig kan du ladda på allmän balans i konsolen.
📘 Fullständig dokumentation: SeeDream Images Generation API →
Begärningsexempel
SeeDream Tasks API kan användas för att kontrollera resultaten från SeeDream Images Generation API. För information om hur man använder SeeDream Images Generation API, se dokumentationen SeeDream Images Generation API. Vi tar ett exempel med ett uppdrag-ID som returnerats av SeeDream Images Generation API, för att demonstrera hur man använder detta API. Anta att vi har ett uppdrag-ID: 20068983-0cc9-4c6a-aeb6-9c6a3c668be0, och vi visar hur man skickar in ett uppdrag-ID.Uppdragsexempelbild
Ställ in begärningshuvuden och begärningskropp
Begärningshuvuden inkluderar:accept: anger att du tar emot svar i JSON-format, här anges somapplication/json.authorization: nyckeln för att anropa API:t, som kan väljas direkt efter ansökan.
id: det uppladdade uppdrag-ID:t.action: hur uppdraget ska hanteras.
Kodexempel
Det kan noteras att olika språkets kod redan har genererats automatiskt på högra sidan, som visas på bilden:
CURL
Svarsexempel
Vid en lyckad begäran kommer API:t att returnera detaljerad information om detta uppdrag. Till exempel:success, statusen för videoproduktionsuppdraget.task_id, ID:t för videoproduktionsuppdraget.trace_id, spårnings-ID:t för videoproduktionen.data, listan över resultaten från bildproduktionsuppdraget.image_url, länken till bildproduktionsuppdraget.prompt, prompten.size: pixelstorleken på den genererade bilden.
Batchfrågeoperation
Detta är för att fråga detaljer om flera uppdrag-ID:n, och till skillnad från ovan måste åtgärden väljas som retrieve_batch. Begärningskropp inkluderar:ids: array av uppladdade uppdrag-ID:n.action: hur uppdraget ska hanteras.
Kodexempel
Några kodexempel är som följer:Svarsexempel
Vid en lyckad begäran kommer API:t att returnera detaljerad information om alla batchuppdrag. Till exempel:items，批量uppgifter av alla specifika detaljer. Det är en array, varje element i arrayen har samma format som resultatet av att fråga enskilda uppgifter ovan.count，antalet av batchfrågeuppgifter.
created_at，uppgiftens skapelsedatum, Unix-tidsstämpel (sekunder, flyttal).started_at，uppgiftens starttid, Unix-tidsstämpel (sekunder, flyttal).finished_at，uppgiftens slutförandetid, Unix-tidsstämpel (sekunder, flyttal). Om uppgiften inte är klar returneras inte detta fält.elapsed，uppgiftens exekveringstid, enhet i sekunder (flyttal, behåll 3 decimaler). Om uppgiften inte är klar returneras inte detta fält.
CURL
Felhantering
Vid anrop av API:et, om ett fel uppstår, kommer API:et att returnera motsvarande felkod och information. Till exempel:400 token_mismatched：Dålig begäran, möjligtvis på grund av saknade eller ogiltiga parametrar.400 api_not_implemented：Dålig begäran, möjligtvis på grund av saknade eller ogiltiga parametrar.401 invalid_token：Obehörig, ogiltig eller saknad auktoriseringstoken.429 too_many_requests：För många begärningar, du har överskridit hastighetsgränsen.500 api_error：Intern serverfel, något gick fel på servern.