{"openapi":"3.1.0","info":{"title":"Video Generator Developer API","version":"1.0.0","description":"Text-only image and video generation. Read models for per-model settings and pricing. Reference media, edits and extensions are not accepted by this API."},"servers":[{"url":"https://www.seedancev2ai.com"}],"security":[{"bearerAuth":[]}],"paths":{"/api/v1/models":{"get":{"operationId":"listModels","summary":"List supported models, settings and credit pricing","responses":{"200":{"description":"Result","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"models":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["image","video"]},"input":{"type":"string","const":"text"},"defaultCredits":{"type":"number"},"defaults":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"pricing":{"type":"array","items":{"type":"object","properties":{"resolution":{"type":"string"},"duration":{"type":"number"},"credits":{"type":"number"}},"required":["credits"],"additionalProperties":false}}},"required":["id","name","type","input","defaultCredits","defaults","pricing"],"additionalProperties":{}}}},"required":["models"],"additionalProperties":false}}}},"400":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"403":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"404":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"409":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"413":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"429":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"503":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}}},"/api/v1/balance":{"get":{"operationId":"getBalance","summary":"Read the connected account balance","responses":{"200":{"description":"Result","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"credits":{"type":"number"},"dailyCreditLimit":{"type":"number"},"resetsAt":{"type":"string"}},"required":["credits","dailyCreditLimit","resetsAt"],"additionalProperties":false}}}},"400":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"403":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"404":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"409":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"413":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"429":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"503":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}}},"/api/v1/tasks":{"get":{"operationId":"listTasks","summary":"Read the latest 20 owned generation tasks","responses":{"200":{"description":"Result","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"tasks":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"model":{"type":"string"},"type":{"type":"string","enum":["image","video"]},"status":{"type":"string"},"creditCost":{"type":"number"},"createdAt":{"type":"string"},"videoUrl":{"type":["string","null"]},"imageUrl":{"type":["string","null"]}},"required":["id","model","type","status","creditCost","createdAt","videoUrl","imageUrl"],"additionalProperties":false}}},"required":["tasks"],"additionalProperties":false}}}},"400":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"403":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"404":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"409":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"413":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"429":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"503":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}}},"/api/v1/tasks/{id}":{"get":{"operationId":"getTask","summary":"Read an owned task; outputs remain null until completed","responses":{"200":{"description":"Result","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"tasks":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"model":{"type":"string"},"type":{"type":"string","enum":["image","video"]},"status":{"type":"string"},"creditCost":{"type":"number"},"createdAt":{"type":"string"},"videoUrl":{"type":["string","null"]},"imageUrl":{"type":["string","null"]}},"required":["id","model","type","status","creditCost","createdAt","videoUrl","imageUrl"],"additionalProperties":false}}},"required":["tasks"],"additionalProperties":false}}}},"400":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"403":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"404":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"409":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"413":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"429":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"503":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1}}]}},"/api/v1/generations":{"post":{"operationId":"generate","summary":"Create one image or video","description":"Confirm the model, settings and credit cost before generation. Unsupported per-model ratios, resolutions and durations are rejected. Poll tasks for completion; never resubmit a pending task with a new key.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[\\w:-]{8,128}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"model":{"type":"string","enum":["seedance-2.0","seedance-2.0-fast","seedance-2-mini","seedance-2.5","nanobanana","nanobanana2","nanobanana-pro","gpt-image-2","seedream-5-lite"]},"prompt":{"type":"string","minLength":3,"maxLength":10000},"ratio":{"type":"string"},"resolution":{"type":"string"},"duration":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["model","prompt"],"additionalProperties":false}}}},"responses":{"200":{"description":"Result","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"tasks":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string"}},"required":["id","status"],"additionalProperties":false}},"creditsUsed":{"type":"number"},"creditsRemaining":{"type":"number"}},"required":["tasks"],"additionalProperties":false}}}},"400":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"403":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"404":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"409":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"413":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"429":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"503":{"description":"Structured error. Keep the same Idempotency-Key on uncertain submission retries.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API key"}}}}