애니메이션 작업 목록

GET /animations의 인증, 필드, 응답, 오류, 안전한 운영을 원본에서 생성한 레퍼런스입니다.

공개 베타API v1 · 1.4.0최종 확인 2026-09-15

이 페이지의 내용

작업

GET /animations

operationId: list_one_click_animations_v1_animations_get

인증 계정 소유 작업을 나열합니다. 다음 페이지에는 next_cursor를 그대로 사용하고 null이면 종료합니다. 한도·요청 예산은 키별이 아닌 계정 전체에 적용됩니다.

인증 및 부수 효과

서버 측 Bearer API 키를 사용하세요. 필요한 권한: animations:read

유료 생성을 시작하지 않습니다. 다른 상태 변경은 위 설명을 확인하세요.

매개변수

매개변수	위치	유형	필수	제약 / 기본값	설명
`limit`	`query`	`integer`	아니요	`minimum`: `1`; `maximum`: `100`; default: `20`	Maximum records in this page, not an account concurrency limit.
`cursor`	`query`	`string` / `null`	아니요	—	Opaque next_cursor from the prior page; pass unchanged.

응답

HTTP	본문	설명
`200`	TaskListResponse	Successful public response. Example values are illustrative.
`400`	APIErrorEnvelope	Invalid input; correct the request before retrying.
`401`	APIErrorEnvelope	Missing, expired, or revoked API key.
`403`	APIErrorEnvelope	Account eligibility, account status, or key scope does not allow this operation.
`404`	APIErrorEnvelope	Resource is unavailable, not owned, or its signature is invalid/expired.
`429`	APIErrorEnvelope	Account-wide rate or queue limit; wait for Retry-After.
`500`	APIErrorEnvelope	Internal failure; preserve the task/key and retry only when marked retryable.
`503`	APIErrorEnvelope	Service/provider unavailable; retry only when error.retryable is true.

응답 헤더

HTTP	헤더	유형	설명
`429`	`Retry-After`	`integer`	Suggested wait in seconds; respect the server value and an overall deadline.
`503`	`Retry-After`	`integer`	Suggested wait in seconds; respect the server value and an overall deadline.

응답 예제

json

{
  "data": [
    {
      "created_at": "2026-08-30T00:00:00Z",
      "credits": {
        "charged": 0,
        "held": 1,
        "quoted": 1
      },
      "error": null,
      "finished_at": null,
      "id": "00000000-0000-4000-8000-000000000002",
      "metadata": {},
      "normalized_input": {},
      "object": "animation",
      "outputs": [],
      "progress": 0,
      "stage": "queued",
      "started_at": null,
      "status": "queued"
    }
  ],
  "next_cursor": null,
  "object": "list"
}

이 문서가 도움이 되었나요?

문서 이용 분석 허용

검색어, 코드 또는 자유 입력 텍스트는 수집하지 않습니다. 이 설정은 문서 상호작용 이벤트만 제어합니다. 개인정보 처리방침

도움이 필요하신가요? 지원팀 문의

문서 검색