AI Studio API

Task status

Poll a generation task and handle queued, running, succeeded, and failed states.

API playground

Send a real request to this site and inspect the HTTP response immediately.

GET

Response

Send a request to view its response here.

작업 진행 상태

이 상태들은 당신의 세대가 대기 중인지, 실행 중인지, 완료되었는지, 실패했는지를 알려줍니다.

queued

running

succeeded

failed

GET/api/ai-studio/tasks/{taskId}

작업 생성 후 taskId와 statusSupported=true가 반환되면 작업 진행 상황을 확인하십시오.

요청 헤더

Authorization: Bearer YOUR_API_KEY

요청 매개변수

이름	타입	필수	기본값	옵션	설명
taskId	string	예	-	-	생성을 시작한 후 반환된 작업 ID.

요청

curl -X GET "https://freesoragenerator.com/api/ai-studio/tasks/provider-task-id" \
  -H "Authorization: Bearer YOUR_API_KEY"

응답 예시

{
  "success": true,
  "data": {
    "generationId": "b6a7f5c4-8a7c-4e2b-8cf6-6b8d9b3d8d21",
    "taskId": "provider-task-id",
    "modelId": "video:sora2-text-to-video-standard",
    "state": "running",
    "mediaUrls": [],
    "raw": {},
    "reservedCredits": 20,
    "refundedCredits": 0
  }
}

오류 예시

{
  "success": false,
  "error": "Generation record not found"
}