Hoppa till huvudinnehåll
Den här artikeln introducerar integrationsmetoden för HappyHorse Videos API. Detta API stöder text-till-video, första bildruta-bild-till-video, referensbild-till-video och videoredigering via den enhetliga ingången /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öder happyhorse-1.0-t2v och happyhorse-1.1-t2v, och kräver att prompt skickas med.
  • image_to_video: första bildruta-bild-till-video, stöder happyhorse-1.0-i2v och happyhorse-1.1-i2v, och kräver att image_url skickas med.
  • reference_to_video: referensbild-till-video, stöder happyhorse-1.0-r2v och happyhorse-1.1-r2v, och kräver att prompt och 1–9 image_urls skickas med.
  • video_edit: videoredigering, stöder happyhorse-1.0-video-edit, och kräver att prompt och video_url skickas med. Dessutom kan 0–5 referensbilder i image_urls skickas med.
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 kräver endast att prompt anges, och du kan även ange parametrar som resolution, ratio och duration:
Ett exempel på returresultatet är följande:
Fältbeskrivning:
  • 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 är pending / succeeded / error.
    • duration: fakturerbar videolängd, i sekunder; för video_edit är detta den sammanlagda längden för in- och utdata-video.
    • resolution: utdataupplösning.
    • ratio: utdataformat.
Motsvarande CURL-kod är följande:
Motsvarande Python-kod är följande:

Första bildruta-bild-till-video

När image_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är reference_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ör video_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 ange callback_url; då returnerar API:et omedelbart task_id, och när uppgiften är klar kommer slutresultatet att POST:as till denna adress:
Det omedelbart returnerade resultatet är följande:
Om du endast vill använda polling och inte behöver något återanrop kan du också ange "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.
Misslyckade uppgifter debiteras inte och förbrukar inte heller den kostnadsfria kvoten.

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