Ansökningsprocess
För att använda Gemini Videos Generation API, gå först till Ace Data Cloud-konsolen för att hämta din API Token och spara den för senare användning.
Om du ännu inte är inloggad eller registrerad omdirigeras du automatiskt till inloggningssidan där du uppmanas att registrera dig och logga in. När det är klart återgår du automatiskt till den aktuella sidan.
En API Token kan anropa alla plattformstjänster, utan att behöva ansöka separat för varje tjänst. Vid första ansökan får du gratis kvot för att kunna testa kostnadsfritt; om kvoten är otillräcklig kan du fylla på det gemensamma saldot i konsolen.
📘 Fullständig dokumentation: Gemini Videos Generation API →
Grundläggande användning
Låt oss först titta på det grundläggande användningssättet. Genom att ange promptenprompt, modellen model och bildförhållandet aspect_ratio kan du generera motsvarande video.
Här kan vi se att Request Headers har angetts, inklusive:
accept: vilket format du vill ta emot svarsresultatet i; här angesapplication/json, alltså JSON-format.authorization: nyckeln för att anropa API:et, som kan väljas direkt från rullgardinsmenyn efter ansökan.
prompt: textprompten som beskriver videoinnehållet som ska genereras, obligatorisk.model: modellen för att generera videon; för närvarande stöds endastomni-flash, och standardvärdet äromni-flash.aspect_ratio: bildförhållandet för den genererade videon; du kan välja16:9(liggande) eller9:16(stående), och standardvärdet är16:9.resolution: valfri utdatupplösning; du kan välja720peller1080p, och standardvärdet är720p.image_urls: valfri array med länkar till referensbilder, som används för att styra videogenereringen; tomma poster ignoreras. Närvideo_urlsanvänds för videoredigering är denna parameter obligatorisk (minst en bild).video_urls: valfri array med länkar till referensvideor (högst 1), som används för videoredigering / videoreferens; när den anges måste minst enimage_urlssamtidigt anges.callback_url: asynkron callback-adress; efter inställning returnerar API:et omedelbarttask_idoch POST:ar resultatet till denna adress när uppgiften är klar.async: valfri; när den sätts tilltruereturnerar gränssnittet omedelbarttask_id, utan behov av att angecallback_url; resultatet hämtas sedan genom polling via motsvarande gränssnitt för uppgiftsförfrågan.
success: om denna begäran om videogenerering lyckades.task_id: ID:t för denna uppgift för videogenerering.trace_id: spårnings-ID:t för denna begäran, som används för felsökning.data: listan över genererade videoresultat.id: den unika identifieraren för den genererade videon.video_url: länkadressen till den genererade videon (nullnärstateärpending).state: statusen för uppgiften för videogenerering; möjliga värden ärpending/succeeded/failed.aspect_ratio: bildförhållandet för denna video, vilket överensstämmer med begärandeparametern.prompt: prompten som användes för att generera denna video.
started_at, finished_at, elapsed (tidsåtgång, sekunder) samt cost (denna debitering, enhet Credit) på toppnivå.
Vi behöver bara hämta den genererade videon via länkadressen video_url i resultatets data.
Motsvarande CURL-kod är följande:
Bild-till-video
Om du vill generera en video baserat på referensbilder kan du skicka in en eller flera bildlänkar iimage_urls för att styra videogenereringen:
Videoredigering / referensvideo (indatavideo, genererad video)
Det går att direkt ”mata in en video och generera en ny video”: ange en länk till en referensvideo (högst 1) ivideo_urls, och ange samtidigt minst en referensbild i image_urls. Använd sedan prompt för att beskriva önskad redigeringseffekt (ändra stil, byt scen, lägg till eller ta bort element osv.).
Nedan följer ett komplett verkligt exempel – en video av en solig strand ändras till en vinterscen med kraftigt snöfall, samtidigt som strandens, palmernas och den lilla båtens placering bevaras. Videoredigering tar relativt lång tid (cirka 6,5 minuter i detta exempel), så den skickas asynkront med async: true:
task_id:
task_id som id för att fråga av Gemini Tasks API. När uppgiften är klar kan du hämta den nya genererade videon (detta är det faktiska svaret från exemplet):
resolution som 1080p (övriga parametrar förblir oförändrade).
Tips: Medielänkarna för indata/utdata i exemplen är verkliga genererade resultat. Video- och bildlänkar som genereras av plattformen har en begränsad giltighetstid och blir ogiltiga efter att de har löpt ut. Ladda ner och spara resultaten i din egen lagring så snart du har fått dem.
Obs: Högst 1 referensvideo kan användas; omvideo_urlsanges måste minst enimage_urlsockså anges, annars returneras följande parameterfel:
Asynkron återuppringning
Videogenerering kräver en viss bearbetningstid. Om du inte vill behålla en lång anslutning och vänta kan du angecallback_url. API:et returnerar då omedelbart task_id, och när uppgiften är slutförd POST:as slutresultatet till denna adress:
Fråga efter uppgiftsresultat
Om du använder asynkron återuppringning eller vill fråga efter uppgiftsstatus aktivt kan du använda Gemini Tasks API (POST https://api.acedata.cloud/gemini/tasks) för att fråga efter den senaste uppgiftsstatusen och resultaten baserat på task_id. Skicka in task_id som returneras när videon skapas som id i begärandekroppen:
response.data är densamma som vid synkron generering (state är pending och video_url är null medan generering pågår):
Felhantering
När ett problem uppstår med begäran returnerar API:et motsvarande felkod och beskrivning. Vanliga fel är:400: Felaktiga begärandeparametrar, till exempel saknasprompteller så är värdet föraspect_ratioogiltigt.401: Autentiseringen misslyckades; token är ogiltig eller matchar inte API:et.403: Otillräckligt saldo, eller så nekades prompten på grund av innehållsgranskning.500: Tjänstfel eller genereringen misslyckades.

