API·시스템 연동
기능 규격
- 입력·출력 인터페이스
- 키·권한·실행 환경
- 작업 상태·결과 조회
- 입력
- 기능별 입력·개발/운영 환경
- 전달
- 호출 API·작업 조회·연동 문서
연동 데이터
- 자료 검색
- 질문과 관련된 원문
- 응답 구성
- 답변과 근거를 함께 정리
- 결과 규격
- 고객 서비스가 사용하는 형식
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}로 조회합니다.