> ## Documentation Index > Fetch the complete documentation index at: https://docs.aireiter.com/llms.txt > Use this file to discover all available pages before exploring further. # AIReiter — AI 텍스트, 이미지 및 비디오 생성 API 플랫폼 > 통합 AI 텍스트, 이미지 및 비디오 생성 API 플랫폼입니다. Claude, GPT, Gemini, Sora2, VEO3, Seedance2 등 다양한 주요 모델을 지원합니다. OpenAI SDK 호환, 비동기 작업 처리, 투명한 가격 책정, 간편한 사용성을 제공합니다. export const apiKeyUrl = 'https://aireiter.com/keys'; 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 작업 흐름 ### 1. 생성 작업 제출 모든 이미지 및 비디오 생성은 비동기 처리 모드를 사용합니다. 작업을 제출할 때 `out_task_id`(발신자 작업 ID)를 전달해야 하며, 시스템은 `out_task_id`를 반환합니다: ```bash theme={null} 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`를 사용하여 작업 진행 상황과 결과를 조회하세요: ```bash theme={null} 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이 포함됩니다: ```json theme={null} { "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 SDK와 호환되며, GPT, Claude 등 모델을 지원합니다 OpenAI 최신 Responses 형식 Anthropic 고유 Messages API 형식 ### 이미지 생성 시리즈 AIReiter는 다양한 이미지 생성 모델을 제공하며, 텍스트에서 이미지 생성 및 이미지 변환 기능을 지원합니다: OpenAI의 고품질 이미지 생성 모델 텍스트에서 이미지 / 이미지 변환 지원, 13가지 비율, 최대 9장 참조 이미지 Google 최신 빠른 이미지 생성 모델 Google 전문 이미지 생성 모델 텍스트에서 이미지, 이미지 변환, 이미지 편집 등 다양한 생성 모드 지원 효율적인 이미지 생성 솔루션 Seedream 4.5 버전 Seedream 최신 버전, 네트워크 검색 강화 생성 지원 ### 비디오 생성 시리즈 텍스트에서 비디오 생성과 이미지에서 비디오 생성을 지원하며, 다양한 해상도와 길이 옵션을 제공합니다: OpenAI Sora2 비디오 생성 모델 (10-15초) Sora2 프로 버전, 고화질 해상도 지원 Google VEO3.1 비디오 생성 모델 VEO3.1 빠른 버전 시작 및 종료 프레임 제어와 오디오 생성 지원 (4-12초) Seedance 빠른 버전, 시작 프레임 제어 지원 Seedance 프로 버전, 시작 및 종료 프레임 제어 지원 다중 참조 이미지, 참조 비디오 및 시작과 종료 프레임 제어 지원 (4-15초) 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 키를 생성하고 관리할 수 있습니다. 모든 생성 작업은 비동기로 처리됩니다. 이미지 생성은 보통 몇 초에서 수십 초 걸리며, 비디오 생성은 길이와 해상도에 따라 보통 1\~5분 소요됩니다. 작업 제출 후 즉시 out\_task\_id가 반환되며, 상태 조회 API를 통해 진행 상황을 추적할 수 있습니다. 작업 상태 조회 API를 사용하여 설정한 `out_task_id`를 전달하세요: ```bash theme={null} POST https://aireiter.com/api/openapi/query ``` 자세한 내용은 [작업 상태 조회 문서](/zh/api-reference/tasks/status)를 참조하세요. `out_task_id`는 작업을 요청하는 쪽에서 설정하는 작업 ID입니다: * **필수 파라미터**: 작업 제출 시 반드시 `out_task_id`를 전달해야 합니다 * **업무 식별**: 시스템 내 주문 번호, 업무 ID 등으로 식별 가능 * **유연한 조회**: `out_task_id`로 직접 작업 상태 조회 가능 * **결과 연동**: 조회 결과에 `out_task_id`가 포함되어 업무 데이터와 연동하기 용이함 AIReiter는 포인트제로 청구됩니다: * 작업 제출 시 예상 소모 포인트(`estimated_credits`) 반환 * 작업 완료 후 실제 소모 포인트(`credits_used`) 반환 * 성공적으로 생성된 내용에 대해서만 요금 청구, 실패한 작업은 청구되지 않음 * 모델에 따라 포인트 소모량 상이 * **이미지**: JPEG, PNG 등 일반적인 형식 지원 * **비디오**: MP4 형식 출력 * **참고 이미지**: 공개 접근 가능한 이미지 URL 입력 지원 ## 다음 단계 텍스트 대화 API 사용 방법 알아보기 다양한 이미지 생성 모델 사용 방법 알아보기 비디오 콘텐츠 생성 방법 알아보기 작업 상태 관리 및 조회 방법 학습하기 지금 바로 AIReiter 사용 시작하기