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

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

빠른 시작

텍스트 대화

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

이미지 생성

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

비디오 생성

VEO3, Seedance2 등의 모델을 사용해 비디오 콘텐츠를 생성합니다.

작업 상태 조회

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

잔액 조회

포인트 잔액 및 각 모델의 무료 할당량 남은 횟수를 조회합니다.

API Key 가져오기

콘솔에 접속하여 API Key를 확인하세요.

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`	플래그십 판, 안정성이 가장 높음

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

사용 시에는 모델 이름을 해당 채널 버전으로 바꾸기만 하면 됩니다. 예를 들어 "seedance2"를 "seedance2_fast"로 바꾸고, 다른 매개변수는 그대로 유지하면 됩니다.

支持的模型

텍스트 대화 시리즈

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 형식

Jev

동기식 의사결정 인터페이스입니다. 자료와 진위형 문제를 제출하면 확률, 선택지 또는 점수를 반환합니다

이미지 생성 시리즈

AIReiter는 다양한 이미지 생성 모델을 제공하며, 텍스트 기반 이미지 생성 및 이미지 투 이미지 기능을 지원합니다:

GPT-4o Image

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

GPT-Image-2

텍스트 기반 이미지 생성 / 이미지 기반 이미지 생성 지원, 13가지 비율, 참조 이미지 최대 9장

GPT-Image-2.5

Flare / Sunburst 2가지 등급, 텍스트 기반 생성 및 참조 이미지 편집, 1K에서 4K까지

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 최신 버전, 웹 검색 강화 생성 지원

비디오 생성 시리즈

텍스트 기반 비디오 생성과 이미지 기반 비디오 생성을 지원하며, 다양한 해상도 및 재생 시간 옵션을 제공합니다:

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 endpoint에서 다양한 텍스트, 이미지, 비디오 생성 모델을 지원합니다:

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

투명한 요금

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

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

유연한 구성

다양한 생성 Parameters 구성을 지원합니다:

이미지: 다양한 가로세로 비율(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 Key 가져오기

​API 작업 흐름

​1. 생성 작업 제출

​2. 작업 상태 조회

​3. 생성 결과 가져오기

​모델 채널

​支持的模型

​텍스트 대화 시리즈

OpenAI Chat Completions API

OpenAI Responses API

Claude Messages API

Jev

​이미지 생성 시리즈

GPT-4o Image

GPT-Image-2

GPT-Image-2.5

Gemini-2.5-Flash (Nano banana)

Gemini-3-Pro (Nano banana pro)

Nano Banana V2

Seedream-4.0

Seedream-4.5

Seedream V5 lite

​비디오 생성 시리즈

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. 생성 결과 가져오기

모델 채널

支持的模型

텍스트 대화 시리즈

이미지 생성 시리즈

비디오 생성 시리즈

핵심 기능

비동기 작업 처리

다중 모델 지원

투명한 요금

유연한 구성

인증 방법

자주 묻는 질문

다음 단계