API-dokumentasjon

Autentisering

Lag en nøkkel på kontoen din og send den i hvert kall, i headeren Authorization: Bearer. Nøkkelen vises bare én gang; ta vare på den som et passord og legg den aldri i kode som kjører i nettleseren. Tilbakekalt slutter den å virke med en gang.

curl https://dorovisual.com/v1/saldo \
  -H "Authorization: Bearer doro_xxxxxxxxxxxx_..."

Betaling

Kun forhåndsbetalt saldo, kun i dollar: du fyller på i USD (minst US$ 10) og hver generering trekker prisen sin. Ingen månedsavgift, og saldoen utløper ikke.

Kreditter fra nettstedets planer betaler ikke for API-et. Også abonnenter bruker dollarsaldoen her.

Beløpet reserveres når genereringen opprettes. Hvis den feiler, avvises eller avbrytes, går hele beløpet tilbake til saldoen. Uten nok saldo er svaret 402, og ingenting opprettes eller belastes.

Priser

Du betaler for den faktiske forbruksenheten: per sekund video og per bilde, etter oppløsning. Bruk /v1/estimativa for å se nøyaktig pris før du genererer.

Video

Bilde

Endepunkter

Base: adressen til dette nettstedet. Pengebeløp er hele dollarcent.

GET/v1/motores

Viser motorene, godtatte parametere (verdier og standarder), godtatte referanser og pris per enhet i dollar. Filtrer med ?tipo=imagem eller ?tipo=video.

curl https://dorovisual.com/v1/motores -H "Authorization: Bearer $DORO_KEY"

POST/v1/estimativa

Forteller hva en generering koster i dollar, uten å opprette noe.

curl https://dorovisual.com/v1/estimativa -H "Authorization: Bearer $DORO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"motor": "seedance_2_0", "params": {"duracao": 5, "resolucao": "720p"}}'

POST/v1/geracoes

Oppretter en generering og returnerer 201 med den i "criando". Felter: motor, prompt, params (valgfritt; det som mangler bruker standard) og webhook_url (valgfritt). Belastes alltid dollarsaldoen.

curl https://dorovisual.com/v1/geracoes -H "Authorization: Bearer $DORO_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: pedido-123" \
  -d '{"motor": "nano_banana_pro", "prompt": "a red fox in the snow, golden hour",
       "params": {"resolucao": "2K", "proporcao": "16:9", "quantidade": 1},
       "webhook_url": "https://example.com/doro/aviso"}'

Med referansebilder sender du multipart/form-data: de samme feltene som tekst (params som JSON) og hvert bilde i feltet referencias (PNG, JPEG eller WebP, opptil 10 MB hver).

curl https://dorovisual.com/v1/geracoes -H "Authorization: Bearer $DORO_KEY" \
  -F motor=seedance_2_0 -F prompt="the fox starts to run" \
  -F 'params={"duracao": 5}' -F [email protected]

{"geracao": {"id": "3f1c…", "motor": "Seedance 2.0", "tipo": "video", "estado": "criando",
  "cobranca": "saldo", "valor": {"moeda": "USD", "centavos": 460}, "arquivos": [],
  "estornado": false, "criado_em": "2026-10-06T12:00:00+00:00", "pronto_em": null}}

GET/v1/geracoes/<id>

Status for genereringen: criando, pronta, falhou eller cancelada. Når den er klar, viser "arquivos" adressen til hver fil. "estornado": true når beløpet er refundert.

curl https://dorovisual.com/v1/geracoes/3f1c… -H "Authorization: Bearer $DORO_KEY"

GET/v1/geracoes/<id>/arquivos/<n>

Videresender (302) til en midlertidig nedlastingslenke for filen. Bruk -L i curl for å følge den.

curl -L -o resultado.mp4 https://dorovisual.com/v1/geracoes/3f1c…/arquivos/0 \
  -H "Authorization: Bearer $DORO_KEY"

POST/v1/geracoes/<id>/cancelar

Avbryter så lenge genereringen ikke har startet, og refunderer beløpet. Etter det: 409 nao_cancelavel.

GET/v1/geracoes?pagina=1

Kontoens genereringer via API-et, nyeste først, 50 per side.

GET/v1/saldo

Dollarsaldoen din, i cent.

{"saldo": {"USD": 2000}}

Prøv igjen uten å betale to ganger

Send headeren Idempotency-Key (bokstaver, tall, . _ : -, opptil 128) på POST /v1/geracoes. Samme nøkkel igjen gir samme generering uten ny belastning: trygt å prøve igjen etter en nettverksfeil.

Varsel når den er ferdig (webhook)

Med webhook_url (https, port 443, offentlig adresse) sender Doro en JSON-POST når genereringen er ferdig: {"evento": "geracao.terminada", "geracao": {...}}, samme innhold som statuskallet. 2xx-svar regnes som levert; opptil 3 forsøk. Videresendinger følges ikke.

Doro-Signature: t=1760000000,v1=5f2b…

# Python
import hmac, hashlib
t, v1 = (p.split("=", 1)[1] for p in header.split(","))
esperado = hmac.new(segredo.encode(), f"{t}.".encode() + corpo, hashlib.sha256).hexdigest()
assert hmac.compare_digest(esperado, v1)

Sjekk Doro-Signature-headeren: HMAC-SHA256 av kontoens hemmelighet (i nøkkelområdet) over "<t>.<innhold>". Avvis varsler med for gammel t.

Grenser

Per nøkkel: 3 genereringer samtidig og 60 per time; per konto: 6 samtidig og 120 per time; og 120 kall per minutt per nøkkel. Over det: 429 med Retry-After-headeren.

Feil

Alle feil er JSON: {"erro": "<kode>"}, med "campo" ved 400. Kodeteksten endres ikke; bruk den i feilhåndteringen din.