List Jobs

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

Reference for List Jobs.

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

Query Parameters

Field	Type	Description
page	int	Page number. Default: 1
limit	int	Items per page. Default: 10
type	string	Filter by job type (see table below)
status	string	Filter by status: "pending", "processing", "complete", "error"
owner	string	Filter by owner
blueprint	string	Filter by blueprint slug

Job Types

Type	Description
GenerateImage	AI image generation
GenerateVideo	AI video generation
VoiceoverVideo	Voiceover video with AI images
StockVideo	Stock footage video with narration
ArticleVideo	Article-to-video conversion
SlideshowVideo	Slideshow video from images
RenderVideo	Custom render from scenes

cURL

bash

curl "https://sangtao.ai/api/v2/jobs?page=1&limit=10&status=complete" \
  -H "X-Api-Key: YOUR_API_KEY"

Response

json

{
  "success": true,
  "data": {
    "items": [
      {
        "jobId": "abc-123",
        "type": "VoiceoverVideo",
        "typeDisplayName": "Voiceover Video",
        "category": "Video",
        "status": "complete",
        "step": null,
        "progress": 100,
        "error": null,
        "resultUrl": "https://cdn.sangtao.ai/videos/result.mp4",
        "resultImages": null,
        "resultData": { "videoUrl": "...", "durationSec": 30 },
        "thumbnailUrl": "https://cdn.sangtao.ai/videos/thumb.jpg",
        "prompt": "Cuối con phố nhỏ ở Hội An...",
        "params": { "voiceId": "vi-VN-HoaiMyNeural", "style": "realistic" },
        "creditCost": 5,
        "elapsedSeconds": 45,
        "createdAt": "2025-06-01T10:30:00Z",
        "processingAt": "2025-06-01T10:30:02Z",
        "completedAt": "2025-06-01T10:30:45Z",
        "retryCount": 0,
        "providerName": "cloud",
        "hasDownloadableAssets": true,
        "parentJobId": null,
        "subType": null,
        "publishStatus": null,
        "publishTitle": null,
        "blueprintName": null,
        "blueprintSlug": null,
        "isOwner": true,
        "ownerName": null
      }
    ],
    "total": 42,
    "page": 1,
    "limit": 10
  }
}

PreviousAccount Balance NextModels