API 작업 제한#

생성 API는 비동기 작업 처리를 사용합니다. 작업이 성공적으로 생성되면 API는 taskId를 반환합니다. 결과 엔드포인트에서 작업 상태, 진행률, 대기열 위치 및 최종 출력을 확인하세요.

이 문서는 분당 요청 수, 미완료 작업 및 여러 작업을 제출할 때의 크레딧 과금 등 API 연동에 적용되는 공개 작업 제한을 설명합니다.

요청 제한 요약#

생성 API는 작업 생성에 고정된 공개 분당 요청 수 제한을 적용하지 않습니다. 실제 제한은 계정에 동시에 존재하는 미완료 작업 수를 기준으로 합니다.

작업 흐름	분당 요청 수	동시 / 미완료 작업	크레딧 과금
AI 3D	고정된 공개 RPM 제한 없음	한 번에 작업 1개 실행. 추가 제출된 작업은 대기열에서 기다립니다.	접수된 작업마다 과금
기타 생성 API	고정된 공개 RPM 제한 없음	계정 및 작업 흐름별 미완료 작업 최대 30개	접수된 작업마다 과금

미완료 작업에는 대기 중인 작업과 실행 중인 작업이 모두 포함됩니다.

30개 작업 제한은 작업 수 제한이며 크레딧 패키지나 무료 할당량이 아닙니다. 접수된 각 생성 작업에는 해당 API의 크레딧 규칙에 따라 요금이 부과됩니다.

결과 엔드포인트는 대기 중인 작업의 대기열 위치를 나타내는 waitNumber를 반환할 수도 있습니다. 작업이 실행 중이거나 종료되면 waitNumber는 보통 0입니다.

AI 3D 작업은 한 번에 하나씩 처리됩니다.

여러 AI 3D 작업을 제출할 수 있으며 성공한 각 제출은 taskId를 반환합니다. 다만 한 번에 실행되는 AI 3D 작업은 하나뿐입니다. 추가 AI 3D 작업은 현재 작업이 끝날 때까지 기다립니다.

권장 연동 동작:

AI 3D 외의 생성 작업 흐름에서는 계정마다 동일한 작업 흐름의 미완료 작업을 최대 30개까지 보유할 수 있습니다.

이는 계정 단위 제한입니다. 같은 계정에 여러 API 키를 생성해도 동일한 제한을 공유합니다.

30개 작업이 항상 정확히 같은 순간에 모두 실행된다는 뜻은 아닙니다. 일부는 대기 중이고 일부는 실행 중일 수 있습니다. 이 제한은 둘 다 포함합니다.

계정에 특정 작업 흐름의 미완료 작업이 이미 30개 있으면 기존 작업이 끝날 때까지 해당 작업 흐름의 새 작업 제출이 일시적으로 거부될 수 있습니다.

코드	이름	의미
`9015`	`TASK_NOT_COMPLETED`	계정이 해당 작업 흐름의 미완료 작업 제한에 도달했습니다. 기존 작업이 완료된 후 재시도하세요.

크레딧은 생성 작업이 성공적으로 생성될 때 차감됩니다. 작업이 최종적으로 실패하면 차감된 크레딧은 자동 환불됩니다.

미완료 작업 제한은 각 작업의 크레딧 비용을 바꾸지 않습니다. 여러 작업을 제출하면 접수된 각 작업에 개별적으로 요금이 부과됩니다.

예:

전체 크레딧 표는 크레딧 차감 참조를 참고하세요.

결과 엔드포인트를 폴링해도 새 생성 작업이 만들어지지 않으며 미완료 작업으로 계산되지 않습니다.

경우에 따라 서비스가 혼잡하여 새 작업 제출이 일시적으로 거부될 수 있습니다. 계정의 미완료 작업이 30개 미만이어도 발생할 수 있습니다.

코드	이름	의미
`5020`	`QUEUE_TASK_OVERFLOW`	현재 서비스가 혼잡합니다. 나중에 재시도하세요.

이는 일시적인 상태입니다. 영구적인 실패로 처리하지 마세요.

권장 재시도 동작:

상황	권장 조치
`9015 TASK_NOT_COMPLETED`	같은 계정 및 작업 흐름의 기존 작업이 완료될 때까지 기다린 후 재시도하세요.
`5020 QUEUE_TASK_OVERFLOW`	기다린 후 재시도 간격을 늘려 가며 재시도하세요.
작업이 `Unprocessed` 상태	계속 폴링하세요. 작업이 대기 중입니다.
작업이 `Processing` 상태	계속 폴링하세요. 작업이 실행 중입니다.

표준 제한인 계정 및 작업 흐름별 미완료 작업 30개로 연동 요구 사항을 충족할 수 없다면 [email protected]로 문의해 주세요. 사용 사례를 검토하고 더 높은 처리량 또는 전용 구성 방안을 논의할 수 있습니다.