Rivya AI-dokumentation
Model-API-sider

ElevenLabs Dialogue V3 API-integration

Brug ElevenLabs Dialogue V3 via Rivya Public API v1 med model-id elevenlabs-dialogue-v3, understøttede inputs, parametre, Files API-regler, credits og svareksempler.

Tilgængelig via APITekstinput klarLyd
API-model-id

elevenlabs-dialogue-v3

Inputs

text

Files API

Ikke krævet for minimal anmodning

Basiscredits

14

Funktion

Lyd

Fakturering

METERED

Promptgrænse

5000 tegn

Anmodningskontrakt

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

NøgleTypeKrævetStandardBeskrivelse
modelstringJaelevenlabs-dialogue-v3Brug API-model-id'et elevenlabs-dialogue-v3.
promptstringNej-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.
params.dialoguearrayJa-Dialoglinjer som objekter med voice og text. Serveren bygger opgaveprompten fra dette array.

Modelparametre

NøgleTypeKrævetStandardIntervalValgmulighederBeskrivelse
default_voiceselectNejAdam-Adam, Alice, Bill, Brian, Callum, Charlie, Chris, Daniel, Eric, George, Harry, Jessica, Laura, Liam, Lily, Matilda, River, Roger, Sarah, WillStandardstemme
stabilityselectNej0.5-0, 0.5, 1Stabilitet
language_codetextNej---Sprogkode

Minimal anmodning

{
  "model": "elevenlabs-dialogue-v3",
  "prompt": "A polished audio concept for a short product story",
  "params": {
    "default_voice": "Adam",
    "stability": "0.5",
    "dialogue": [
      {
        "voice": "Adam",
        "text": "Welcome to the product walkthrough."
      },
      {
        "voice": "Alice",
        "text": "Here is the short version for developers."
      }
    ]
  }
}

Oprettelsessvar

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

{
  "id": "task_elevenlabs_dialogue_v3_example",
  "status": "queued",
  "model": "elevenlabs-dialogue-v3",
  "reserved_credits": 14,
  "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

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