레퍼런스v1.0.0 안정 버전

PavoAI Pro API

고성능 AI 이미지 생성 기능을 서비스에 통합할 수 있습니다. 이 문서는 완전한 API 레퍼런스, 연동 가이드, 코드 예제를 제공하여 개발자가 빠르게 AI 이미지 애플리케이션을 구축할 수 있도록 돕습니다.

https://pavoai.pro
01

퀵 스타트

생성 작업을 제출하고 상태를 폴링하는 두 단계만으로 첫 번째 API 호출을 완료할 수 있습니다.

1

작업 제출

POST 요청을 generate 엔드포인트로 보내 Task ID를 받습니다.

2

상태 조회

Task ID를 사용해 진행 상황을 확인하고, 이미지 URL이 반환될 때까지 조회합니다.

02

인증

주의: API 키는 안전하게 보관하고, 클라이언트 사이드 코드에 노출하지 마세요.

HTTP 헤더
Authorization: Bearer {YOUR_API_KEY}
POST
https://pavoai.pro/api/generate

Create a new image generation task. This endpoint is asynchronous and returns a task_id plus initial status; call /api/status to retrieve the final images.

This endpoint responds immediately with task_id. Poll /api/status until the status becomes SUCCESS to obtain image URLs.

본문 파라미터

파라미터 이름타입필수 여부설명
promptstring필수Text prompt for generation (max 1000 characters).
aspect_ratiostring필수Aspect ratio for the generated image. Allowed values: 1:1, 4:3, 3:4, 16:9, 9:16.
응답(JSON)
{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "task_1234567890",
    "status": "IN_PROGRESS"
  }
}
GET
https://pavoai.pro/api/status

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

쿼리 파라미터

파라미터 이름필수 여부설명
task_id필수작업을 제출할 때 반환된 ID입니다.
응답 예시
{
  "code": 200,
  "message": "success",
  "data": {
    "status": "SUCCESS",
    "task_id": "xxxxxxxx",
    "request": {
      "prompt": "A beautiful sunset over mountains",
      "aspect_ratio": "16:9"
    },
    "response": [
      "https://cdn.example.com/images/task_xxx_0.jpeg"
    ],
    "consumed_credits": 15,
    "created_at": "2025-12-05 13:05:09",
    "error_message": null
  }
}

결제

요청당 비용

$0.02 / 요청

실패한 작업에는 비용이 청구되지 않습니다.

오류 처리

  • 401 Invalid API key유효하지 않은 API 키입니다.
  • 402 Payment Required잔액이 부족합니다.
  • 429 Too Many Requests요청 한도에 도달했습니다.
03

PavoAI Pro 소개

PavoAI Pro is an independent browser workspace for supported AI image, video, audio, speech, and finishing workflows.

PavoAI Pro — 하나의 작업 공간에서 이미지와 동영상 워크플로 사용

PavoAI Pro는 지원되는 이미지 및 동영상 모델을 연결하는 브라우저 작업 공간입니다. 이미지 작업 공간의 기본 모델은 GPT Image 2.5이고 동영상 작업 공간의 기본 모델은 Seedance 2.5입니다.

프로젝트에 맞는 워크플로 선택

정지 이미지와 참조에는 이미지 작업 공간을, 텍스트에서 동영상과 이미지에서 동영상에는 동영상 작업 공간을 사용하고, 공유 도구로 정리·사운드·음성·자막·마무리를 진행하세요.

작업 공간에서 할 수 있는 일

  • 이미지 제작 — 이미지 작업 공간에서 정지 이미지, 참조, 제품 비주얼과 콘셉트를 만듭니다.
  • 동영상 모델 — 장면, 움직임, 형식과 입력에 맞는 모델을 선택합니다.
  • 이미지에서 동영상 — 지원되는 이미지 입력으로 참조를 움직입니다.
  • 편집 도구 — 이미지와 동영상 정리, 업스케일, 자막 및 관련 도구를 이어서 사용합니다.
  • 오디오와 음성 — 소리를 추가하고 음성을 분리하거나 받아쓰고 음성을 생성합니다.
  • 개발자 액세스 — 지원되는 통합에 API Keys와 API 문서를 사용합니다.

사용 방법

  • promptprompt – 장면이나 시각적 결과를 자연어로 설명합니다.
  • sizeaspect_ratio – 지원되는 이미지 출력 비율을 선택합니다.
  • seedmodel – 지원되는 이미지 또는 동영상 워크플로를 선택합니다.
이미지 생성동영상 생성

© 2026 PavoAI Pro Inc. 판권 소유.