/happyhorse/videos-ingången och parametern action.
Ansökningsprocess
För att använda HappyHorse Videos API går du 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 har loggat in eller registrerat dig omdirigeras du automatiskt till inloggningssidan där du uppmanas att registrera dig och logga in. När detta är klart återvänder du automatiskt till den aktuella sidan.
En API Token kan anropa alla plattformens tjänster, utan att behöva ansöka separat för varje tjänst. Vid den första ansökan får du kostnadsfria krediter för att prova tjänsten utan kostnad; när krediterna inte räcker till kan du fylla på ditt generella saldo i konsolen.
📘 Fullständig dokumentation: HappyHorse Videos API →
Åtgärdstyper
action avgör genereringsläget för den aktuella begäran:
generate: text-till-video, standardåtgärden, stöderhappyhorse-1.0-t2vochhappyhorse-1.1-t2v, och kräver attpromptanges.image_to_video: bild-till-video med första bildrutan, stöderhappyhorse-1.0-i2vochhappyhorse-1.1-i2v, och kräver attimage_urlanges.reference_to_video: bild-till-video med referensbilder, stöderhappyhorse-1.0-r2vochhappyhorse-1.1-r2v, och kräver attpromptoch 1–9image_urlsanges.video_edit: videoredigering, stöderhappyhorse-1.0-video-edit, och kräver attpromptochvideo_urlanges; 0–5 referensbilder viaimage_urlskan dessutom anges.
video_edit har för närvarande endast happyhorse-1.0-video-edit.
Grundläggande användning
Text-till-video behöver bara angeprompt, och kan även ange parametrar som resolution, ratio och duration:
success: om den aktuella begäran lyckades.task_id: uppgifts-ID på Ace Data Cloud-sidan, som kan användas för att kontrollera uppgiftsstatusen.trace_id: spårnings-ID för den aktuella begäran, som används för felsökning.data: lista över videoresultat.id: uppgifts-ID på HappyHorse-sidan.video_url: CDN-länkadressen till den genererade videon.state: uppgiftsstatus, möjliga värden ärpending/succeeded/error.duration: fakturerad videolängd, i sekunder; förvideo_editär detta den sammanlagda längden för in- och utgående video.resolution: utdatans upplösning.ratio: utdatans bildförhållande.
Bild-till-video med första bildrutan
Närimage_to_video används fungerar image_url som videons första bildruta. Utdatans bildförhållande följer i möjligaste mån bilden i den första bildrutan, så denna åtgärd behöver inte ange ratio.
Bild-till-video med referensbilder
Närreference_to_video används kan 1–9 referensbilder anges i image_urls. I prompten kan bilderna i motsvarande ordning refereras till med exempelvis character1, character2 och så vidare.
Videoredigering
Närvideo_edit används måste videon som ska redigeras, video_url, och redigeringsavsikten, prompt, anges. Valfria image_urls används som referensbilder, till exempel för klädbyte, stilöverföring eller lokal ersättning. audio_setting kan vara antingen auto eller origin, där origin innebär att det ursprungliga videoljudet behålls.
Asynkron återuppringning
Videogenerering kräver viss bearbetningstid. Om du inte vill behålla en lång anslutning och vänta kan du skicka incallback_url, varpå API:t omedelbart returnerar task_id. När uppgiften är slutförd POST:as slutresultatet till denna adress:
"async": true och sedan fråga efter uppgiftsresultatet via HappyHorse Tasks API.
Information om debitering
HappyHorse debiterar baserat på antalet sekunder i den utgående videon och upplösningen:720P: från cirka $0.105 / sekund.1080P: från cirka $0.18 / sekund.video_edit: debiteras utifrån den sammanlagda längden på indata- och utdata-videon. Den faktiska debiterbara längden baseras på statistiken efter att uppgiften har slutförts.
Felhantering
När det uppstår problem med begäran returnerar API:t motsvarande felkod och beskrivning. Vanliga fel är följande:400: Felaktiga begärandeparametrar, till exempel att action och model inte matchar, attprompt/image_url/video_urlsaknas eller attdurationligger utanför intervallet 3–15 sekunder.401: Autentiseringen misslyckades, token är ogiltig eller matchar inte API:t.403: Otillräckligt saldo, eller så har prompten avvisats eftersom den träffade innehållsgranskningen.429: Begäran sker för ofta och hastighetsbegränsning har utlösts. Försök igen senare.500: Internt serverfel eller genereringen misslyckades.

