LogoAPI in One
Dashboard

API 문서

API in One을 애플리케이션에 통합하는 데 필요한 모든 것.

인증

모든 API 요청에는 Authorization 헤더에 Bearer 토큰이 필요합니다. 대시보드에서 API 키를 관리할 수 있습니다.

http
Authorization: Bearer aio_your_api_key_here

API 키 받기: 대시보드의 API 키 페이지에서 무료 API 키를 생성하세요. 신규 계정에는 플랫폼 탐색을 위한 보너스 크레딧이 지급됩니다.

기본 URL

https://apiin.one/api/v1

API 엔드포인트

POST/api/v1/images/generations
POST/api/v1/videos/generations
POST/api/v1/audio/music
POST/api/v1/audio/speech
POST/api/v1/chat/completions
POST/api/v1/images/tools/remove-bg
GET/api/v1/tasks/{task_id}

요청 형식

모든 요청은 사용할 AI 모델을 지정하는 필수 'model' 필드가 포함된 JSON 본문을 사용합니다. 추가 매개변수는 모델에 따라 다릅니다.

json
{
  "model": "flux-2",
  "prompt": "A beautiful landscape",
  "...other_params": "..."
}

'model' 매개변수는 항상 필수입니다. 지원되는 매개변수의 전체 목록은 각 모델의 문서 페이지를 참조하세요.

응답 형식

비동기 작업 (이미지, 비디오, 음악, 음성)

콘텐츠 생성 모델의 경우 API는 즉시 작업 ID를 반환합니다. 상태 엔드포인트를 폴링하여 작업 완료를 확인합니다.

Initial response when task is created.

{
  "id": "task_abc123",
  "status": "pending",
  "model": "kling-3",
  "created_at": "2026-02-24T12:00:00Z"
}

동기 응답 (채팅)

채팅 완성은 OpenAI 호환 형식으로 단일 요청에서 직접 응답을 반환합니다.

json
{
  "id": "chatcmpl_xyz",
  "model": "gemini",
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "..."
      }
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 156,
    "total_tokens": 168
  },
  "credits_consumed": 2
}

오류 처리

모든 오류는 오류 코드, 메시지, 유형이 포함된 일관된 JSON 형식으로 반환됩니다.

json
{
  "error": {
    "code": 401,
    "message": "Invalid API key",
    "type": "authentication_error"
  }
}
Status Code유형필수설명
400invalid_request선택 사항잘못된 요청 매개변수. 필수 필드는 모델 문서를 확인하세요.
401authentication_error선택 사항API 키가 없거나, 유효하지 않거나, 해지되었습니다.
402insufficient_credits선택 사항계정 크레딧이 부족합니다. 계속 사용하려면 크레딧을 추가 구매하세요.
404not_found선택 사항요청한 리소스(작업, 모델)를 찾을 수 없습니다.
429rate_limit선택 사항요청 속도 제한 초과. 기본값은 분당 60회 요청입니다.
500server_error선택 사항내부 서버 오류. 잠시 후 다시 시도해 주세요.

빠른 시작

1. API 키 받기

가입하고 대시보드에서 API 키를 생성하세요. 무료 계정에는 보너스 크레딧이 포함됩니다.

2. 첫 번째 요청 보내기

bash
curl -X POST https://apiin.one/api/v1/images/generations \
  -H "Authorization: Bearer aio_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-2",
    "prompt": "A serene Japanese garden with cherry blossoms"
  }'

3. 작업 상태 확인 (비동기 모델)

bash
curl https://apiin.one/api/v1/tasks/task_abc123 \
  -H "Authorization: Bearer aio_your_key"

4. 더 많은 모델 탐색

모델 디렉토리를 둘러보고 사용 사례에 적합한 AI 모델을 찾아보세요.

모든 모델 둘러보기 →

API Tester

Test the API directly from your browser:

API 테스트 환경POST