메인 콘텐츠로 건너뛰기
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": "veo3_1",
    "params": {
      "prompt": "이 이미지를 움직이게 하세요",
      "image_url": "https://example.com/reference.jpg",
      "aspect_ratio": "16:9"
    },
    "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

​
본문

​
model
string
필수
모델 이름고정 값: "veo3_1"
​
params
object
필수
모델 파라미터 객체
​
out_task_id
string
필수
발신자 작업 ID사용자가 지정한 작업 식별자, 필수
​
callback_url
string
작업 완료 후 콜백 알림 주소작업 완료 시 시스템이 이 주소로 POST 요청하여 결과를 알림
​
metadata
object
사용자 정의 메타데이터조회 결과 시 그대로 반환되며, 비즈니스 식별에 사용 가능

​
Response

​
task_id
string
작업 ID, 결과 조회에 사용
​
out_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": "veo3_1",
    "params": {
      "prompt": "이 이미지를 움직이게 하세요",
      "image_url": "https://example.com/reference.jpg",
      "aspect_ratio": "16:9"
    },
    "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"
  }
}