Videostatus abrufen

GET https://api.ofox.io/v1/videos/{id}

Fragen Sie Status und Ergebnis einer Aufgabe ab. Nachdem Sie eine Aufgabe erstellt haben, fragen Sie diesen Endpunkt ab, bis status einen terminalen Zustand erreicht — completed, failed, cancelled oder expired.

curl https://api.ofox.io/v1/videos/9bcf3c60-7db2-4e1a-a1b2-c3d4e5f60718 \
  -H "Authorization: Bearer $OFOX_API_KEY"

Ratenbegrenzung

Dieser Endpunkt ist pro API Key ratenbegrenzt (standardmäßig 5 req/s mit einem Burst von 20). Anfragen über dem Limit geben 429 rate_limited mit einem Retry-After: 1-Header zurück. Erstellen (POST) und Abbrechen (DELETE) unterliegen diesem Limit nicht.

Antwort

{
  "id": "9bcf3c60-7db2-4e1a-a1b2-c3d4e5f60718",
  "status": "completed",
  "model": "bytedance/seedance-2.5",
  "prompt": "A golden retriever running on the beach at sunset",
  "unsigned_urls": ["https://upstream.example/out.mp4"],
  "mirror_urls":   ["https://cdn.ofox.io/videos/vgen_xxx.mp4?sig=..."],
  "usage": {
    "video_seconds": 5,
    "video_cost": "0.4000000000"
  },
  "created_at": 1776211362,
  "updated_at": 1776211400
}

{
  "id": "9bcf3c60-7db2-4e1a-a1b2-c3d4e5f60718",
  "status": "failed",
  "model": "bytedance/seedance-2.5",
  "prompt": "A golden retriever running on the beach at sunset",
  "error": {
    "code": "expired",
    "message": "Generation timed out"
  },
  "created_at": 1776211362,
  "updated_at": 1776211600
}

Ein Timeout wird als status: "failed" gemeldet, wobei error.code auf expired gesetzt ist. Die vollständige Liste der Fehlercodes finden Sie unter Fehlercodes.

Das Video-Objekt

State machine

Sieben Zustände, basierend auf der OpenRouter-Benennung und erweitert um cancelled / expired.

Übergänge: pending → queued → in_progress → completed ist der Erfolgspfad. Jeder nicht-terminale Zustand kann zu failed, cancelled oder expired wechseln.

Video URLs

Eine erfolgreiche Aufgabe kann zwei URL-Sätze zurückgeben, je nachdem, ob der Anbieter des Modells CDN-Spiegelung aktiviert hat.