/happyhorse/videos och parametern action.
Ansökningsprocess
För att använda HappyHorse Videos API, gå först till Ace Data Cloud-konsolen för att hämta din API-token och spara den för framtida bruk.
Om du ännu inte har loggat in eller registrerat dig omdirigeras du automatiskt till inloggningssidan där du blir inbjuden att registrera dig och logga in. När detta är klart återgår 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. Den första ansökan ger kostnadsfria krediter för gratis provanvändning; när krediterna inte räcker till kan du fylla på ditt allmänna saldo i konsolen.
📘 Fullständig dokumentation: HappyHorse Videos API →
Åtgärdstyper
action avgör genereringsläget för denna begäran:
generate: text-till-video, standardåtgärden, stöderhappyhorse-1.0-t2vochhappyhorse-1.1-t2v, och kräver attpromptskickas med.image_to_video: första bildruta-bild-till-video, stöderhappyhorse-1.0-i2vochhappyhorse-1.1-i2v, och kräver attimage_urlskickas med.reference_to_video: referensbild-till-video, stöderhappyhorse-1.0-r2vochhappyhorse-1.1-r2v, och kräver attpromptoch 1–9image_urlsskickas med.video_edit: videoredigering, stöderhappyhorse-1.0-video-edit, och kräver attpromptochvideo_urlskickas med. Dessutom kan 0–5 referensbilder iimage_urlsskickas med.
video_edit har för närvarande endast happyhorse-1.0-video-edit.
Grundläggande användning
Text-till-video kräver endast attprompt anges, och du kan även ange parametrar som resolution, ratio och duration:
success: om denna begäran lyckades.task_id: uppgifts-ID på Ace Data Cloud-sidan, som kan användas för att fråga efter uppgiftsstatus.trace_id: spårnings-ID för denna 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: fakturerbar videolängd, i sekunder; förvideo_editär detta den sammanlagda längden för in- och utdata-video.resolution: utdataupplösning.ratio: utdataformat.
Första bildruta-bild-till-video
Närimage_to_video används används image_url som videons första bildruta. Utdataformatet följer i möjligaste mån den första bildrutan, så denna åtgärd behöver inte skicka med ratio.
Referensbild-till-video
Närreference_to_video används kan 1–9 referensbilder skickas i image_urls. I prompten kan bilderna i motsvarande ordning refereras till med exempelvis character1, character2 och så vidare.
Videoredigering
Utdataformatet och längden förvideo_edit ärvs från källvideon. Att skicka duration eller ratio ändrar dem inte; formatet för bild-till-video ärver också källbildens format. Redigeringsavgiften beräknas utifrån den sammanlagda längden för in- och utdata-video.
När video_edit används måste videon som ska redigeras, video_url, och redigeringsavsikten, prompt, skickas med. 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 den ursprungliga videons ljud behålls.
Asynkront återanrop
Videogenerering kräver en viss bearbetningstid. Om du inte vill behålla en lång anslutning och vänta kan du angecallback_url; då returnerar API:et omedelbart task_id, och när uppgiften är klar kommer slutresultatet att POST:as till denna adress:
"async": true och därefter använda HappyHorse Tasks API för att hämta uppgiftsresultatet.
Prisinformation
HappyHorse debiterar baserat på antalet sekunder i utdatavideon och upplösningen:720P: från cirka 0,105 $ / sekund.1080P: från cirka 0,18 $ / sekund.video_edit: debiteras baserat på den sammanlagda längden av inmatningsvideon och utdatavideon; den faktiska debiterade längden baseras på statistiken efter att uppgiften har slutförts.
Felhantering
När ett problem uppstår med begäran returnerar API:et motsvarande felkod och beskrivning. Vanliga exempel ä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: Autentisering misslyckades; token är ogiltig eller matchar inte API:et.403: Otillräckligt saldo, eller så avvisades prompten efter att ha träffat innehållsgranskningen.429: Begäranden görs för ofta, vilket har utlöst hastighetsbegränsning. Försök igen senare.500: Internt serverfel eller genereringen misslyckades.

