메인 콘텐츠로 건너뛰기
AIReiter는 이미지와 비디오 생성 서비스를 제공하는 통합 AI 콘텐츠 생성 API 플랫폼입니다. 간단한 REST API 호출을 통해 GPT-4o, Gemini, Sora2, VEO3 등 다양한 주류 AI 모델을 사용하여 고품질 이미지와 비디오 콘텐츠를 생성할 수 있습니다.

​
빠른 시작

이미지 생성

GPT-4o, Gemini, Seedream 등의 모델을 사용하여 이미지를 생성합니다

비디오 생성

Sora2, VEO3 등의 모델을 사용하여 비디오 콘텐츠를 생성합니다

작업 상태 조회

비동기 작업의 실행 상태와 결과를 조회합니다

API Key 받기

콘솔에 접속하여 API Key를 받으세요

​
API 작업 흐름

​
1. 생성 작업 제출

모든 이미지 및 비디오 생성은 비동기 처리 방식을 사용합니다. 작업 제출 시 out_task_id(발신자 작업 ID)를 전달해야 하며, 시스템은 task_id와 out_task_id를 반환합니다: 
curl --request POST \
  --url https://test.aireiter.com/api/openapi/submit \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt_4o",
    "params": {
      "prompt": "정원에 있는 귀여운 고양이",
      "aspect_ratio": "1:1"
    },
    "out_task_id": "my_task_123456"
  }'

​
2. 작업 상태 조회

반환된 task_id 또는 제출한 out_task_id로 작업 진행 상황과 결과를 조회할 수 있습니다(둘 중 하나 선택): 
# task_id 사용 조회
curl --request POST \
  --url https://test.aireiter.com/api/openapi/query \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "task_id": "order_xxxxxxxxxxxx"
  }'

# 또는 out_task_id 사용 조회
curl --request POST \
  --url https://test.aireiter.com/api/openapi/query \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "out_task_id": "my_task_123456"
  }'

​
3. 생성 결과 획득

작업 완료 후, 응답에 생성된 이미지 또는 비디오 URL이 포함됩니다: 
{
  "statusCode": 200,
  "message": "",
  "data": {
    "task_id": "order_xxxxxxxxxxxx",
    "out_task_id": "my_task_123456",
    "status": "completed",
    "output": [
      {
        "url": "https://s1.pxz.ai/upload/image-generator/xxx.jpeg"
      }
    ]
  }
}

​
지원 모델

​
이미지 생성 시리즈

AIReiter는 다양한 이미지 생성 모델을 제공하며, 텍스트로부터 이미지 생성과 이미지로부터 이미지 생성 기능을 지원합니다:

GPT-4o Image

OpenAI의 고품질 이미지 생성 모델

Gemini-2.5-Flash (Nano banana)

Google의 최신 고속 이미지 생성 모델

Gemini-3-Pro (Nano banana pro)

Google의 전문가용 이미지 생성 모델

Seedream-4.0

효율적인 이미지 생성 솔루션

Seedream-4.5

Seedream 최신 버전

​
비디오 생성 시리즈

텍스트로부터 비디오 생성과 이미지로부터 비디오 생성 기능을 지원하며, 다양한 해상도와 길이 옵션을 제공합니다:

Sora2

OpenAI Sora2 비디오 생성 모델 (10-15초)

Sora2 Pro

Sora2 프로 버전, 고해상도를 지원

VEO3.1

Google VEO3.1 비디오 생성 모델

VEO3.1 Fast

VEO3.1 빠른 버전

​
핵심 기능

​
비동기 작업 처리

모든 생성 요청은 비동기 처리 방식을 채택하여 긴 대기 시간을 피합니다:
  • 작업 제출 시 out_task_id(발신자 작업 ID, 비즈니스 식별용)를 전달해야 합니다
  • 시스템에서 생성된 task_id와 제출한 out_task_id를 즉시 반환합니다
  • task_id 또는 out_task_id로 작업 상태를 조회할 수 있습니다(둘 중 하나 선택)
  • 웹훅 콜백 알림 지원(선택 사항)
  • 작업 상태 실시간 업데이트: pending → processing → completed

​
다중 모델 지원

하나의 통합 API 엔드포인트에서 다양한 이미지 및 영상 생성 모델을 지원합니다:
  • 이미지 생성: GPT-4o, Gemini, Seedream 등 5개 모델
  • 영상 생성: Sora2, VEO3 등 4개 모델
  • 일관된 요청 형식과 응답 구조
  • 유연한 매개변수 설정

​
투명한 가격 정책

포인트 기반 과금으로 투명하고 명확합니다:
  • 각 작업별 예상 소모 포인트 제공
  • 작업 완료 후 실제 소모 포인트 표시
  • 성공적으로 생성된 콘텐츠에 대해서만 비용 청구
  • 숨겨진 비용 없음

​
유연한 구성

다양한 생성 매개변수 구성을 지원합니다:
  • 이미지: 여러 가로세로비(1:1, 3:2, 2:3)
  • 영상: 여러 가로세로비(16:9, 9:16), 길이(10초, 15초), 해상도
  • 참조 이미지 지원(이미지 생성 이미지, 이미지 생성 영상)
  • 사용자 정의 메타데이터(metadata)

​
인증 방법

모든 API 요청은 Bearer Token을 사용하여 인증해야 합니다: 
Authorization: Bearer YOUR_API_KEY
API Key 얻기: API Key 관리 페이지에 접속하여 API Key를 얻으세요.

​
자주 묻는 질문

API Key 관리 페이지에 접속하여 로그인하면 API Key를 생성하고 관리할 수 있습니다.
모든 생성 작업은 비동기 처리됩니다. 이미지 생성은 보통 몇 초에서 수십 초가 소요되며, 비디오 생성은 길이와 해상도에 따라 보통 1~5분이 걸립니다. 작업을 제출하면 즉시 task_id가 반환되며, 상태 조회 API로 진행 상황을 추적할 수 있습니다.
작업 상태 조회 API를 사용하여 제출 시 반환된 task_id 또는 직접 설정한 out_task_id 중 하나를 전달할 수 있습니다:
POST https://test.aireiter.com/api/openapi/query
자세한 내용은 작업 상태 조회 문서를 참고하세요.
out_task_id는 작업 발신자의 작업 ID이며, 작업 제출 시 직접 설정하는 값입니다:
  • 필수 파라미터: 작업 제출 시 반드시 out_task_id를 전달해야 합니다.
  • 비즈니스 식별: 시스템 내 주문 번호, 비즈니스 ID 등으로 사용할 수 있습니다.
  • 유연한 조회: 시스템이 반환하는 task_id를 저장하지 않아도 out_task_id로 작업 상태를 바로 조회할 수 있습니다.
  • 결과 연동: 조회 결과에 task_id와 out_task_id가 함께 반환되어 비즈니스 데이터와 연동하기 편리합니다.
네, 작업 제출 시 callback_url 파라미터를 전달할 수 있습니다. 작업 완료 후 시스템이 해당 주소로 POST 요청을 보내며, 완전한 작업 결과를 포함합니다.
AIReiter는 포인트 기반 과금을 채택하고 있습니다:
  • 작업 제출 시 예상 소비 포인트(estimated_credits)를 반환합니다.
  • 작업 완료 시 실제 소비 포인트(credits_used)를 반환합니다.
  • 성공적으로 생성된 콘텐츠에 대해서만 요금이 청구되며, 실패한 작업은 요금이 없습니다.
  • 모델별로 포인트 소비가 다릅니다.
  • 이미지: JPEG, PNG 등 일반적인 포맷 지원
  • 비디오: MP4 포맷 출력
  • 참조 이미지: 공개 접근 가능한 이미지 URL 입력 지원

​
다음 단계

이미지 생성 문서 보기

다양한 이미지 생성 모델 사용하는 방법을 알아보세요

비디오 생성 문서 보기

비디오 콘텐츠 생성 방법을 알아보세요

작업 관리

작업 상태를 관리하고 조회하는 방법을 배우세요

API Key 받기

AIReiter를 즉시 시작하세요