sangtao.ai
API key

Jobs

List jobs

GEThttps://api.sangtao.ai/v2/jobs

Authorization

  • X-Api-Keystring · headerrequired

    Your API key, from the API keys page of your account.

List all jobs for the current user with pagination and optional filters. Use this to build job history, dashboard, or management views.

Query parameters

  • pageint

    Page number. Default: 1

  • pageSizeint

    Jobs per page. Default 10, at most 100. limit is accepted as the same thing.

  • typestring

    Filter by job type (described under Job types below)

    Available options:AgentJobRenderVideo

  • statusstring

    Filter by status

    Available options:pendingprocessingcompleteerror

  • blueprintstring

    Filter by blueprint slug

Response

data.items holds the jobs, with total, page and limit (the page size) beside it. Each item reads as GET /jobs/{jobId} does — creditCost, resultData and, for a failed job, failureKind included — except params, which is null in the list: open the job for them. resultData.thumbnailUrl is the job's thumbnail when it has one.

Job types

TypeDescription
AgentJobGPT Image (POST /images/generations)
RenderVideoCustom render from scenes
GET/jobs
curl "https://api.sangtao.ai/v2/jobs?page=1&pageSize=10&status=complete" \
  -H "X-Api-Key: YOUR_API_KEY"
{
  "success": true,
  "data": {
    "items": [
      {
        "jobId": "acff47cbfacf4e27bbc08770c9ea246d",
        "type": "AgentJob",
        "typeDisplayName": "Agent Job",
        "category": "agent",
        "status": "complete",
        "step": null,
        "progress": 100,
        "error": null,
        "failureKind": null,
        "resultUrl": "https://cdn.sangtao.ai/agent-jobs/acff47cb.../fa3c91.png",
        "resultImages": [
          "https://cdn.sangtao.ai/agent-jobs/acff47cb.../fa3c91.png"
        ],
        "resultData": {
          "resultUrl": "https://cdn.sangtao.ai/agent-jobs/acff47cb.../fa3c91.png",
          "imageUrls": [
            "https://cdn.sangtao.ai/agent-jobs/acff47cb.../fa3c91.png"
          ],
          "width": 1024,
          "height": 1024,
          "durationMs": 13100
        },
        "thumbnailUrl": null,
        "prompt": "A vintage travel poster of Ha Long Bay at sunset",
        "params": null,
        "creditCost": 0,
        "elapsedSeconds": 13.1,
        "createdAt": "2026-09-19T09:42:59Z",
        "processingAt": "2026-09-19T09:43:17Z",
        "completedAt": "2026-09-19T09:43:30Z",
        "retryCount": 0,
        "hasDownloadableAssets": true,
        "title": null,
        "queuePosition": null,
        "etaSeconds": null,
        "etaCompleteSeconds": null
      }
    ],
    "total": 42,
    "page": 1,
    "limit": 10
  }
}