AIReiter — AI 텍스트, 이미지 및 비디오 생성 API 플랫폼

AIReiter는 텍스트 대화, 이미지 생성, 동영상 생성 서비스를 제공하는 통합 AI 콘텐츠 생성 API 플랫폼입니다. 간단한 REST API 호출을 통해 Claude, GPT, Gemini, Sora2, VEO3, Seedance2 등 다양한 주류 AI 모델을 사용할 수 있습니다. 텍스트 인터페이스는 OpenAI SDK와 완전히 호환되어 baseURL을 직접 교체하여 사용할 수 있습니다.

빠른 시작

텍스트 대화

OpenAI SDK 호환, Claude, GPT 등 모델 지원

이미지 생성

GPT-4o, Gemini, Seedream 등 모델로 이미지 생성

비디오 생성

Sora2, VEO3, Seedance2 등 모델로 비디오 콘텐츠 생성

작업 상태 조회

비동기 작업의 실행 상태와 결과 조회

잔액 조회

포인트 잔액 및 각 모델 무료 한도 남은 횟수 조회

API 키 받기

콘솔에 접속하여 API 키 받기

API 작업 흐름

1. 생성 작업 제출

모든 이미지 및 비디오 생성은 비동기 처리 모드를 사용합니다. 작업을 제출할 때 out_task_id(발신자 작업 ID)를 전달해야 하며, 시스템은 out_task_id를 반환합니다:

curl --request POST \
  --url https://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. 작업 상태 조회

제출한 out_task_id를 사용하여 작업 진행 상황과 결과를 조회하세요:

curl --request POST \
  --url https://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": {
    "out_task_id": "my_task_123456",
    "status": "completed",
    "output": [
      {
        "url": "https://s1.pxz.ai/upload/image-generator/xxx.jpeg"
      }
    ]
  }
}

모델 채널

모델 채널은 서로 다른 서비스 등급을 나타냅니다. 각 모델은 여러 채널 버전을 제공하며, 네 가지 등급으로 나뉩니다:

채널	설명
`base`	기본 버전, 가장 저렴한 가격
`plus`	강화 버전
`advanced`	고급 버전
`max`	플래그십 버전, 가장 높은 안정성

채널은 서비스 안정성에만 영향을 미치며 출력 품질에는 영향을 주지 않습니다. 모든 채널은 동일한 기본 모델을 사용하여 생성 결과의 품질은 완전히 동일합니다. 일반적으로 가격이 높은 채널일수록 서비스 안정성이 더 좋습니다.

사용할 때는 모델 이름을 해당 채널 버전으로 교체하면 됩니다. 예를 들어 "sora2"를 "sora2_plus"로 바꾸고, 다른 매개변수는 그대로 둡니다.

지원하는 모델

텍스트 대화 시리즈

OpenAI Chat Completions API 및 Responses API와 호환되며 다중 대화, 도구 호출, 구조화된 출력, 스트리밍 응답을 지원합니다:

OpenAI Chat Completions API

OpenAI SDK와 호환되며 GPT, Claude 등의 모델을 지원합니다

OpenAI Responses API

OpenAI 최신 Responses 포맷

Claude Messages API

Anthropic 네이티브 Messages API 포맷

이미지 생성 시리즈

AIReiter는 다양한 이미지 생성 모델을 제공하며 텍스트에서 이미지 생성과 이미지 변환 기능을 지원합니다:

GPT-4o Image

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

Gemini-2.5-Flash (Nano banana)

Google 최신 빠른 이미지 생성 모델

Gemini-3-Pro (Nano banana pro)

Google 전문 이미지 생성 모델

Nano Banana V2

텍스트 변환 이미지, 이미지 변환, 이미지 편집 등 다양한 생성 모드를 지원

Seedream-4.0

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

Seedream-4.5

Seedream 4.5 버전

Seedream V5 lite

Seedream 최신 버전으로 네트워크 검색 강화 생성 지원

비디오 생성 시리즈

텍스트에서 비디오, 이미지에서 비디오 생성 지원하며 다양한 해상도와 길이 옵션을 제공합니다:

Sora2

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

Sora2 Pro

Sora2 전문 버전, 고해상도 지원

VEO3.1

Google VEO3.1 비디오 생성 모델

VEO3.1 Fast

VEO3.1 빠른 버전

Seedance-1.5-pro

시작 및 종료 프레임 제어와 오디오 생성 지원 (4-12초)

Seedance Pro Fast

Seedance 빠른 버전, 시작 프레임 제어 지원

Seedance Pro

Seedance 전문 버전, 시작 및 종료 프레임 제어 지원

Seedance 2.0

다중 참조 이미지, 참조 비디오 및 시작/종료 프레임 제어 지원 (4-15초)

Seedance 2.0 Fast

Seedance 2.0 빠른 버전, 다중 참조 이미지 및 시작/종료 프레임 제어 지원

핵심 기능

비동기 작업 처리

모든 생성 요청은 비동기 처리 모드를 사용하여 장시간 대기를 방지합니다:

작업 제출 시 out_task_id(발신자 작업 ID, 비즈니스 식별용)를 전달해야 합니다
제출한 out_task_id를 즉시 반환합니다
out_task_id를 사용하여 작업 상태를 조회할 수 있습니다
webhook 콜백 알림 지원(선택 사항)
작업 상태 실시간 업데이트: pending → processing → completed

다중 모델 지원

단일 API 엔드포인트에서 다양한 텍스트, 이미지 및 비디오 생성 모델을 지원합니다:

텍스트 대화: Claude, GPT 등 모델, OpenAI SDK 호환
이미지 생성: GPT-4o, Gemini, Seedream 등 모델
비디오 생성: Sora2, VEO3, Seedance 등 모델
통합된 요청 형식과 응답 구조
유연한 매개변수 구성

투명한 가격 정책

포인트 기반 과금으로 투명하고 명확합니다:

각 작업은 예상 소모 포인트를 반환합니다
작업 완료 후 실제 소비 포인트 표시
성공적으로 생성된 콘텐츠에 대해서만 비용 청구
숨겨진 비용 없음

유연한 구성

다양한 생성 매개변수 구성을 지원합니다:

이미지: 다양한 가로 세로 비율(1:1, 3:2, 2:3)
비디오: 다양한 가로 세로 비율(16:9, 9:16), 길이(10초, 15초), 해상도
참조 이미지 지원(이미지 기반 이미지, 이미지 기반 비디오)

인증 방법

모든 API 요청은 Bearer Token을 사용하여 인증해야 합니다:

Authorization: Bearer YOUR_API_KEY

API Key 얻기: API Key 관리 페이지에 접속하여 API Key를 얻으세요.

자주 묻는 질문

API 키는 어떻게 얻나요?

API 키 관리 페이지에 접속하여 로그인하면 API 키를 생성하고 관리할 수 있습니다.

이미지와 비디오 생성에는 얼마나 걸리나요?

모든 생성 작업은 비동기로 처리됩니다. 이미지 생성은 보통 몇 초에서 수십 초 걸리며, 비디오 생성은 길이와 해상도에 따라 보통 1~5분 소요됩니다. 작업 제출 후 즉시 out_task_id가 반환되며, 상태 조회 API를 통해 진행 상황을 추적할 수 있습니다.

작업 상태는 어떻게 조회하나요?

작업 상태 조회 API를 사용하여 설정한 out_task_id를 전달하세요:

POST https://aireiter.com/api/openapi/query

자세한 내용은 작업 상태 조회 문서를 참조하세요.

out_task_id란 무엇인가요?

out_task_id는 작업을 요청하는 쪽에서 설정하는 작업 ID입니다:

필수 파라미터: 작업 제출 시 반드시 out_task_id를 전달해야 합니다
업무 식별: 시스템 내 주문 번호, 업무 ID 등으로 식별 가능
유연한 조회: out_task_id로 직접 작업 상태 조회 가능
결과 연동: 조회 결과에 out_task_id가 포함되어 업무 데이터와 연동하기 용이함

요금은 어떻게 청구되나요?

AIReiter는 포인트제로 청구됩니다:

작업 제출 시 예상 소모 포인트(estimated_credits) 반환
작업 완료 후 실제 소모 포인트(credits_used) 반환
성공적으로 생성된 내용에 대해서만 요금 청구, 실패한 작업은 청구되지 않음
모델에 따라 포인트 소모량 상이

지원하는 이미지 및 비디오 형식은 무엇인가요?

이미지: JPEG, PNG 등 일반적인 형식 지원
비디오: MP4 형식 출력
참고 이미지: 공개 접근 가능한 이미지 URL 입력 지원

다음 단계

텍스트 대화 문서 보기

텍스트 대화 API 사용 방법 알아보기

이미지 생성 문서 보기

다양한 이미지 생성 모델 사용 방법 알아보기

비디오 생성 문서 보기

비디오 콘텐츠 생성 방법 알아보기

작업 관리

작업 상태 관리 및 조회 방법 학습하기

API Key 받기

지금 바로 AIReiter 사용 시작하기

개요

이미지 시리즈

비디오 시리즈

작업 관리

​빠른 시작

텍스트 대화

이미지 생성

비디오 생성

작업 상태 조회

잔액 조회

API 키 받기

​API 작업 흐름

​1. 생성 작업 제출

​2. 작업 상태 조회

​3. 생성 결과 가져오기

​모델 채널

​지원하는 모델

​텍스트 대화 시리즈

OpenAI Chat Completions API

OpenAI Responses API

Claude Messages API

​이미지 생성 시리즈

GPT-4o Image

Gemini-2.5-Flash (Nano banana)

Gemini-3-Pro (Nano banana pro)

Nano Banana V2

Seedream-4.0

Seedream-4.5

Seedream V5 lite

​비디오 생성 시리즈

Sora2

Sora2 Pro

VEO3.1

VEO3.1 Fast

Seedance-1.5-pro

Seedance Pro Fast

Seedance Pro

Seedance 2.0

Seedance 2.0 Fast

​핵심 기능

​비동기 작업 처리

​다중 모델 지원

​투명한 가격 정책

​유연한 구성

​인증 방법

​자주 묻는 질문

​다음 단계

텍스트 대화 문서 보기

이미지 생성 문서 보기

비디오 생성 문서 보기

작업 관리

API Key 받기

빠른 시작

API 작업 흐름

1. 생성 작업 제출

2. 작업 상태 조회

3. 생성 결과 가져오기

모델 채널

지원하는 모델

텍스트 대화 시리즈

이미지 생성 시리즈

비디오 생성 시리즈

핵심 기능

비동기 작업 처리

다중 모델 지원

투명한 가격 정책

유연한 구성

인증 방법

자주 묻는 질문

다음 단계