Produktions-Checkliste

Produktionsreife beginnt vor dem API-Aufruf: Eingaben prüfen, Preis schätzen, taskId speichern und Ergebnisse asynchron behandeln.

Praktische Grundlagen

Wählen Sie das Modell nach der wichtigsten Eigenschaft — Tempo, Genauigkeit, Auflösung oder Kontrolle — und speichern Sie Parameter und Version jedes Ergebnisses. the model selected for the task — Production checklist.

Ändern Sie pro Versuch nur eine Sache. Gute Ausgaben werden zu Referenzen und damit zum zuverlässigsten Ausgangspunkt der nächsten Iteration.

Behandeln Sie finished und failed als Endzustände. Nutzen Sie Polling oder Webhooks, bewahren Sie Rohfehler serverseitig auf und zeigen Sie Nutzerinnen und Nutzern nur sichere Meldungen.

Prompts und API-Beispiele

{
  "model": "veo3.1-fast",
  "input": { "prompt": "…", "aspectRatio": "16:9" },
  "webhook": "https://example.com/hooks/api-stock/8f2c1e9a-b40d-4c77-9a1e-secret"
}

{
  "code": 402,
  "error": {
    "message": "Insufficient balance. Please top up your account",
    "type": "PaymentRequired",
    "code": "insufficient_balance"
  }
}

  curl https://api.api-stock.com/api/v1/user/me \
    -H "Authorization: Bearer sk-your-key"

  {
    "code": 200,
    "data": {
      "id": "019c1f70-2b44-70d3-9c22-6b7ad0f41e18",
      "balance": 48250,
      "createdAt": "2026-01-14T09:03:11.000Z"
    }
  }

curl https://api.api-stock.com/api/v1/catalog

curl https://api.api-stock.com/api/v1/catalog/veo3.1-fast