메인 콘텐츠로 건너뛰기
GET
https://api.apimart.ai
/
v1
/
tasks
/
{task_id}
curl --request GET \
  --url https://api.apimart.ai/v1/tasks/task-unified-1757156493-imcg5zqt?language=ko \
  --header 'Authorization: Bearer <token>'
{
  "code": 200,
  "data": {
    "id": "task_01KA040M0HP1GJWBJYZMKX1XS1",
    "status": "completed",
    "progress": 100,
    "result": {
      "images": [
        {
          "url": [
            "https://upload.apimart.ai/f/image/9998236911693428-e8d7441f-f7b4-4130-97ad-9ef8a0dde2ce-image_task_01KA0413RT2GGNZJ9GWQ4PXF2F_0.png"
          ],
          "expires_at": 1763174708
        }
      ]
    },
    "created": 1763088289,
    "completed": 1763088308,
    "estimated_time": 60,
    "actual_time": 19
  }
}
curl --request GET \
  --url https://api.apimart.ai/v1/tasks/task-unified-1757156493-imcg5zqt?language=ko \
  --header 'Authorization: Bearer <token>'
{
  "code": 200,
  "data": {
    "id": "task_01KA040M0HP1GJWBJYZMKX1XS1",
    "status": "completed",
    "progress": 100,
    "result": {
      "images": [
        {
          "url": [
            "https://upload.apimart.ai/f/image/9998236911693428-e8d7441f-f7b4-4130-97ad-9ef8a0dde2ce-image_task_01KA0413RT2GGNZJ9GWQ4PXF2F_0.png"
          ],
          "expires_at": 1763174708
        }
      ]
    },
    "created": 1763088289,
    "completed": 1763088308,
    "estimated_time": 60,
    "actual_time": 19
  }
}

인증

Authorization
string
required
모든 API 엔드포인트에는 Bearer Token 인증이 필요합니다API 키 가져오기:API 키 관리 페이지를 방문하여 API 키를 가져오세요요청 헤더에 추가:
Authorization: Bearer YOUR_API_KEY

경로 매개변수

task_id
string
required
생성 API에서 반환된 작업 ID

쿼리 매개변수

language
string
응답 콘텐츠의 언어, 다음 값을 지원:
  • zh - 중국어
  • en - 영어
  • ko - 한국어
  • ja - 일본어
기본값은 영어

응답

id
string
고유한 작업 식별자
status
string
작업 상태 값:
  • pending - 처리 대기 중
  • processing - 진행 중
  • completed - 성공적으로 완료됨
  • failed - 실패
  • cancelled - 사용자에 의해 취소됨
progress
integer
작업 진행률 (0–100)
result
object
작업 결과, 상태가 completed일 때만 반환됩니다
created
integer
작업 생성 타임스탬프
completed
integer
작업 완료 타임스탬프 (완료 시에만 존재)
estimated_time
integer
예상 완료 시간(초)
actual_time
integer
실제 완료 시간(초) (완료 시에만 존재)
error
object
오류 세부정보 (상태가 failed일 때만 존재)