메인 콘텐츠로 건너뛰기
POST
https://test.aireiter.com
/
api
/
openapi
/
submit
curl --request POST \
  --url https://test.aireiter.com/api/openapi/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "sora2",
    "params": {
      "prompt": "한 마리 고양이가 정원에서 산책합니다",
      "aspect_ratio": "16:9",
      "video_length": "10"
    },
    "out_task_id": "my_task_123456"
  }'

{
  "statusCode": 200,
  "message": "",
  "data": {
      "task_id": "order_p9EyMzcBxkH7zxQhlnP6k",
      "out_task_id": "my_task_123456",
      "out_task_id": "my_task_123456",
      "status": "pending",
      "estimated_credits": 100,
      "created_at": "2025-12-22T06:03:28.242Z"
  }
}

​
Authorizations

​
Authorization
string
필수
모든 엔드포인트는 Bearer Token 인증이 필요합니다.API Key 받기:API Key 관리 페이지에 접속하여 API Key를 받으세요.요청 헤더에 아래와 같이 추가하여 사용합니다:
Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
필수
모델 이름고정값: "sora2"
​
params
object
필수
모델 매개변수 객체
​
out_task_id
string
필수
발신자 작업 ID사용자가 정의한 작업 식별자, 필수 입력
​
callback_url
string
작업 완료 후 콜백 알림 주소작업 완료 시 시스템이 해당 주소로 POST 요청을 보내 결과를 알림
​
metadata
object
사용자 정의 메타데이터조회 결과 시 그대로 반환, 비즈니스 식별용으로 사용 가능

​
Response

​
task_id
string
작업 ID로 결과를 조회하는 데 사용됩니다
​
out_task_id
string
발신자 작업 ID로 결과 조회에 사용할 수 있습니다
​
status
string
초기 상태로, 고정값 "pending"
​
estimated_credits
number
예상 소모 크레딧
​
created_at
string
생성 시간(ISO 형식)
curl --request POST \
  --url https://test.aireiter.com/api/openapi/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "sora2",
    "params": {
      "prompt": "한 마리 고양이가 정원에서 산책합니다",
      "aspect_ratio": "16:9",
      "video_length": "10"
    },
    "out_task_id": "my_task_123456"
  }'

{
  "statusCode": 200,
  "message": "",
  "data": {
      "task_id": "order_p9EyMzcBxkH7zxQhlnP6k",
      "out_task_id": "my_task_123456",
      "out_task_id": "my_task_123456",
      "status": "pending",
      "estimated_credits": 100,
      "created_at": "2025-12-22T06:03:28.242Z"
  }
}