내 서비스에 AI를,쉽게 연결하세요.

문서 정리, 자료 검색, 콘텐츠·학습 문제 생성. 필요한 AI 기능을 PAI API로 웹사이트와 앱에 연결합니다.

사용 예시 보기 도입 문의

기존 웹사이트와 앱을 상징하는 모니터와 스마트폰 오브젝트 — 기존 서비스 → PAI → 결과 활용

서비스와 AI의 연결을 상징하는 PAi 블루 게이트웨이 오브젝트 — 기존 서비스 → PAI → 결과 활용

내 서비스에 더할 AI 기능

AI 활용 예시

원본 문서

서비스 연동 안내서

고객 서버는 API 키로 요청을 인증합니다. 작업 접수 후 받은 작업 ID로 상태를 조회하고, 완료된 결과 파일을 기존 서비스에서 사용합니다.

구조화된 결과

원본 문서에서 정리한 항목별 결과
항목	내용
요청 주체	고객 서버
인증 방식	API 키
처리 흐름	작업 접수 → 상태 조회 → 결과 활용

데이터·JSON 보기

기능: AI 문서 처리
입력 형식: 문서 텍스트
결과 형식: 항목별 정리

{
  "title": "서비스 연동 안내서",
  "text": "고객 서버는 API 키로 요청을 인증합니다. 작업 접수 후 받은 작업 ID로 상태를 조회하고, 완료된 결과 파일을 기존 서비스에서 사용합니다.",
  "fields": [
    {
      "name": "요청 주체",
      "value": "고객 서버"
    },
    {
      "name": "인증 방식",
      "value": "API 키"
    },
    {
      "name": "처리 흐름",
      "value": "작업 접수 → 상태 조회 → 결과 활용"
    }
  ]
}

서비스는 그대로.
AI 처리는 PAI로.

사용 중인 서비스

회원과 자료 관리
이용자 화면 제공
AI 결과 활용

PAI

AI 기능 처리
처리 상태 관리
결과 전달

기술 구조 보기

고객 시스템Your application

웹·앱·업무 화면회원·상품·업무 데이터

고객 서버API 키 보관 · 요청 전송

결과 화면처리 결과를 기존 서비스에 반영

PAIAPI 게이트웨이

인증·접근 제어업체·환경 · 키별 권한

실행 프로필입력 규격 · 고정된 버전

작업 요청접수 · 작업 ID 발급

큐·워커비동기 처리

AI 기능 처리프로필 적용 · 결과 가공

결과 반환상태 · 결과 파일

파일 전달비공개 파일 · 다운로드 권한

크레딧예약 → 실행 → 정산

이미지·영상 작업의 시스템 경계

API 연동 방식 보기 구축 사례 보기

필요한 기능부터 시작하세요.

개발자 연동 예시

01
API 키 발급
고객 콘솔에서 개발·운영 키와 기능 권한을 설정합니다.
02
샘플 프로젝트 확인
examples/mock-flow.ts
GET /v1/profiles에서 사용할 프로필을 확인합니다.
03
작업 요청
POST /v1/jobs
접수한 작업 ID를 저장합니다.
04
결과 조회
GET /v1/jobs/{id}
완료된 작업의 결과 파일을 다운로드합니다.

curl "$PAI_API_URL/v1/jobs" \
  -H "Authorization: Bearer $PLATFORM_API_KEY" \
  -H "Idempotency-Key: YOUR_REQUEST_ID" \
  -H "Content-Type: application/json" \
  --data '{
    "profile": "YOUR_PROFILE",
    "input": { "product": { "name": "상품명" } },
    "output": { "aspect_ratio": "portrait" }
  }'

import { GatewayClient } from "@gateway/sdk";

const client = new GatewayClient({
  baseUrl: process.env.PAI_API_URL!,
  apiKey: process.env.PLATFORM_API_KEY!,
});

const job = await client.submit({
  profile: "YOUR_PROFILE",
  input: { product: { name: "상품명" } },
  output: { aspect_ratio: "portrait" },
}, crypto.randomUUID());

const status = await client.getStatus(job.job_id);

고객 서버에서 실행하세요. PAI_API_URL·PLATFORM_API_KEY를 설정하고, YOUR_PROFILE을 허용된 프로필로 바꾸세요.

202 접수 응답 주요 필드

{
  "job_id": "YOUR_JOB_ID",
  "status": "QUEUED",
  "profile_version": 1,
  "execution_mode": "MOCK",
  "is_ai_generated": false
}

결과가 준비되면 GET /v1/jobs/{id}로 조회합니다.

요청·응답 상세 문서

키·권한·사용량 관리

개발·운영 키: 환경과 키별 기능·실행 프로필 권한을 구분합니다.
업체별 접근: 작업과 파일을 업체의 권한 범위 안에서 조회합니다.
실행 설정: 프로필 버전을 관리하고 접수한 작업의 설정을 유지합니다.
사용량·크레딧: 작업별 사용량과 청구 크레딧, 잔액과 한도를 관리합니다.

자주 묻는 질문

기존 서비스의 회원·DB도 옮겨야 하나요?

회원·상품·업무 데이터는 기존 서비스에 유지합니다.

결과는 어떻게 받나요?

작업 ID로 조회하고, 완료된 파일은 다운로드 API로 받습니다.

개발 환경과 운영 환경을 나눌 수 있나요?

개발·운영 키별로 기능과 실행 프로필 권한을 설정합니다.

사용량과 크레딧은 어디서 확인하나요?

고객 콘솔에서 확인합니다. 잔액과 사용 한도는 요청 시 적용됩니다.

PAI를 서비스에 연결하세요.

API 키 발급 도입 상담

내 서비스에 AI를,쉽게 연결하세요.

내 서비스

AI를 더한 서비스

내 서비스에 더할 AI 기능

문서 정리·분석

자료 검색·질문 응답

이미지·영상 제작

학습 문제 생성

AI 활용 예시

서비스 연동 안내서

구조화된 결과

서비스는 그대로.
AI 처리는 PAI로.

사용 중인 서비스

PAI

필요한 기능부터 시작하세요.

API 키 발급

샘플 프로젝트 확인

작업 요청

결과 조회

PAI를 서비스에 연결하세요.