Skip to main content
Detta dokument introducerar integrationsmetoden för HappyHorse Videos API. Detta API stöder text-till-video, bild-till-video med första bildrutan, bild-till-video med referensbilder och videoredigering via den enhetliga /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öder happyhorse-1.0-t2v och happyhorse-1.1-t2v, och kräver att prompt anges.
  • image_to_video: bild-till-video med första bildrutan, stöder happyhorse-1.0-i2v och happyhorse-1.1-i2v, och kräver att image_url anges.
  • reference_to_video: bild-till-video med referensbilder, stöder happyhorse-1.0-r2v och happyhorse-1.1-r2v, och kräver att prompt och 1–9 image_urls anges.
  • video_edit: videoredigering, stöder happyhorse-1.0-video-edit, och kräver att prompt och video_url anges; 0–5 referensbilder via image_urls kan dessutom anges.
Varje åtgärd använder som standard 1.1-modellen; video_edit har för närvarande endast happyhorse-1.0-video-edit.

Grundläggande användning

Text-till-video behöver bara ange prompt, och kan även ange parametrar som resolution, ratio och duration:
Ett exempel på returresultatet är följande:
Fältbeskrivning:
  • 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 är pending / succeeded / error.
    • duration: fakturerad videolängd, i sekunder; för video_edit är detta den sammanlagda längden för in- och utgående video.
    • resolution: utdatans upplösning.
    • ratio: utdatans bildförhållande.
Motsvarande cURL-kod är följande:
Motsvarande Python-kod är följande:

Bild-till-video med första bildrutan

När image_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är reference_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är video_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 in callback_url, varpå API:t omedelbart returnerar task_id. När uppgiften är slutförd POST:as slutresultatet till denna adress:
Det omedelbart returnerade resultatet är följande:
Om du endast vill polla och inte behöver en återanropning kan du också skicka in "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.
Misslyckade uppgifter debiteras inte och förbrukar inte heller den kostnadsfria kvoten.

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, att prompt / image_url / video_url saknas eller att duration ligger 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.