Rivya AI-dokumentation
Model-API-sider

Wan 2.2 A14B Turbo API-integration

Brug Wan 2.2 A14B Turbo via Rivya Public API v1 med model-id wan-2-2-a14b-turbo, understøttede inputs, parametre, Files API-regler, credits og svareksempler.

Tilgængelig via APITekst eller URL klar; referencetilstande bruger Files APIVideo
API-model-id

wan-2-2-a14b-turbo

Inputs

text, file

Files API

Krævet for referencetilstande

Basiscredits

12

Funktion

Video

Fakturering

FIXED

Promptgrænse

5000 tegn

Anmodningskontrakt

Send model-id'et på øverste niveau. Modelspecifikke kontroller hører hjemme i params.

NøgleTypeKrævetStandardBeskrivelse
modelstringJawan-2-2-a14b-turboBrug API-model-id'et wan-2-2-a14b-turbo.
promptstringJa-Maksimalt 5000 tegn for denne model.
paramsobjectNej-Modelspecifikt parameterobjekt. Brug rækkerne nedenfor til de tilladte keys.
client_request_idstringNej-Valgfrit klientside-id til at spore anmodninger i dit system.

Modelparametre

NøgleTypeKrævetStandardIntervalValgmulighederBeskrivelse
resolutionselectNej720p-480p, 580p, 720pTekst- og billedkørsler bliver i øjeblikket på `480p / 720p`, mens den billede-plus-lyd-drevne vej også viser `580p`. Rivya filtrerer automatisk ikke-understøttede niveauer baseret på den aktuelle tilstand.
aspect_ratioselectNej16:9-16:9, 9:16Dette er kun tilgængeligt i tekst-til-video, fordi de nuværende offentlige billed- og billede-plus-lyd-drevne endpoints ikke viser et stabilt `aspect_ratio`-felt.
enable_prompt_expansionselectNejfalse-false, trueSlå dette til, når du vil have upstream-tjenesten til at udvide en grov tekstprompt før generering. Det forbliver begrænset til tekst- og billedkørsler.
seednumberNej-min 0 / max 2147483647-Lad feltet stå tomt for et nyt tilfældigt resultat hver gang. Genbrug af det samme heltal gør det lettere at reproducere eller finjustere et tidligere resultat. Det holder sig kun tættere på, når prompten og andre vigtige indstillinger også forbliver nogenlunde ens, og det garanterer ikke et 1:1-match.
accelerationselectNejnone-none, regularEn lettere accelerationskontrol, der forbliver begrænset til de offentlige tekst- og billedtilstande.
num_framesnumberNej80min 40 / max 120 / step 1-Kun billede-plus-lyd-drevet. Gyldige værdier er 40 til 120, og tallet skal være deleligt med 4. Et typisk startpunkt er 80.
frames_per_secondnumberNej16min 4 / max 60 / step 1-Kun billede-plus-lyd-drevet. Gyldige værdier er 4 til 60. Højere FPS føles normalt mere glidende, men øger også genereringspresset.
negative_prompttextNej---Kun billede-plus-lyd-drevet. Brug den til at beskrive bevægelsesfejl, uønskede artefakter eller visuelle elementer, du vil undgå.
num_inference_stepsnumberNej27min 2 / max 40 / step 1-Kun billede-plus-lyd-drevet. Gyldige værdier er 2 til 40. Flere trin kan forbedre kvaliteten, men de øger også køretiden.
guidance_scalenumberNej3.5min 1 / max 10 / step 0.1-Kun billede-plus-lyd-drevet. Gyldige værdier er 1 til 10. Højere værdier følger prompten tættere, men kan også få bevægelsen til at føles stivere.
shiftnumberNej5min 1 / max 10 / step 0.1-Kun billede-plus-lyd-drevet. Gyldige værdier er 1 til 10. Det ændrer den tidslige offset-fornemmelse i genereringen, så det er sikrest at starte tæt på standarden.
enable_safety_checkerselectNejtrue-true, falseKun billede-plus-lyd-drevet. Slå det til for at køre sikkerhedstjek før generering, eller slå det fra, når du har brug for mindre filtrering og accepterer afvejningen.

Uploadpolitik

Upload først referencefiler, og placer derefter den returnerede URL og duration-token i params.referenceMediaItems.

Referenceregel

Referencemedier: Upload op til 2 assets. Teksttilstand kræver ingen, billede-til-video bruger 1 billede, og den billede-plus-lyd-drevne vej bruger 1 billede plus 1 lydklip.

Maks. filer

2

Accepterede filtyper

image, audio

Duration-token

Video- og lydreferencer bør medtage durationToken fra /api/v1/files, når varighedsverifikation er krævet.

kindMaks. størrelseMIME-typer
image10 MBimage/jpeg, image/png, image/webp
audio10 MBaudio/mpeg, audio/mp4, audio/wav, audio/x-wav, audio/aac, audio/ogg, audio/flac, audio/x-ms-wma

Minimal anmodning

{
  "model": "wan-2-2-a14b-turbo",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "enable_prompt_expansion": "false",
    "seed": 0,
    "acceleration": "none",
    "num_frames": 80,
    "frames_per_second": 16,
    "negative_prompt": "Valgfri udelukkelser eller fejltilstande, der skal undgås.",
    "num_inference_steps": 27,
    "guidance_scale": 3.5,
    "shift": 5,
    "enable_safety_checker": "true"
  }
}

Referencefilanmodning

{
  "model": "wan-2-2-a14b-turbo",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "enable_prompt_expansion": "false",
    "seed": 0,
    "acceleration": "none",
    "num_frames": 80,
    "frames_per_second": 16,
    "negative_prompt": "Valgfri udelukkelser eller fejltilstande, der skal undgås.",
    "num_inference_steps": 27,
    "guidance_scale": 3.5,
    "shift": 5,
    "enable_safety_checker": "true",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Oprettelsessvar

Oprettelsesendpointet returnerer et offentligt opgave-id. Hent status fra statusendpointet, indtil opgaven lykkes eller fejler.

{
  "id": "task_wan_2_2_a14b_turbo_example",
  "status": "queued",
  "model": "wan-2-2-a14b-turbo",
  "reserved_credits": 12,
  "final_credits": 0,
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Almindelige fejl

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Nogle tilstande kræver referenceuploads via Files API.