Generate Endpoint - VicSee API Video & Image Generation

Create AI-generated content using a unified endpoint. Also available as agent tools via the VicSee MCP Server.

POST /api/v1/generate

Request

Headers

Body Parameters

Options

Example Request

curl -X POST https://vicsee.com/api/v1/generate \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0-text-to-video",
    "prompt": "A timelapse of a flower blooming",
    "options": {
      "duration": 10,
      "aspectRatio": "16:9"
    }
  }'

Response

{
  "success": true,
  "data": {
    "id": "task_abc123",
    "model": "seedance-2-0-text-to-video",
    "status": "processing",
    "creditsUsed": 550,
    "creditsRemaining": 1450,
    "createdAt": "2024-12-27T10:30:00.000Z"
  }
}

Response Fields

Next Steps

1. Save the id from the response
2. Poll GET /api/v1/tasks/id for status updates
3. When status is completed, download your content

Request Errors

These codes are returned by POST /api/v1/generate when a request is rejected before a task is created. They arrive as an HTTP 4xx/5xx response with { "success": false, "error": { "code": ... } }. They are distinct from a task that is created and later fails during processing — that case returns HTTP 200 with status: "failed" (poll GET /api/v1/tasks/{id} for details).