Apiframe는 이미지, 동영상, 음악 AI 생성을 위한 통합 REST API입니다. Midjourney, Flux, Kling, Sora, Suno 등 주요 모델을 지원합니다. 이 가이드를 따라하면 1분 이내에 첫 이미지를 생성할 수 있습니다.
사전 준비 사항
시작하기 전에 다음이 필요합니다:
- REST API에 대한 기본적인 이해
- HTTP 클라이언트(curl, Postman, 또는 선호하는 프로그래밍 언어의 HTTP 라이브러리)
- Apiframe 계정 — console.apiframe.ai에서 가입
1단계: 계정 만들기
console.apiframe.ai에 접속해 이메일을 입력하고 'Send Magic Link'를 클릭하거나 GitHub으로 로그인하세요. 가입 즉시 사용할 수 있는 무료 크레딧 100개가 지급됩니다 — 악용 방지를 위해 휴대폰 인증이 필요하며, 휴대폰 인증이 어려운 경우 동일한 100크레딧을 1달러에 구매할 수 있습니다.
2단계: API 키 발급받기
로그인 후 대시보드의 API Keys로 이동합니다. 새 키를 생성하고 안전한 곳에 보관하세요. Apiframe v2 API 키는 afk_로 시작합니다.
⚠️
클라이언트 사이드 코드나 공개 저장소에서 API 키를 절대 노출하지 마세요.
3단계: 첫 번째 요청 보내기
POST /v2/images/generate로 요청을 보냅니다. API 키는 X-API-Key 헤더로 전달하고, 요청 본문에 모델과 프롬프트를 지정합니다.
javascriptgenerate-image.js
const response = await fetch('https://api.apiframe.ai/v2/images/generate', {
method: 'POST',
headers: {
'X-API-Key': 'afk_your_api_key_here',
'Content-Type': 'application/json',
},
body: JSON.stringify({
prompt: 'a futuristic city skyline at sunset, cyberpunk style',
model: 'midjourney',
}),
});
const data = await response.json();
console.log(data); // { jobId: 'abc-123', status: 'QUEUED' }pythongenerate-image.py
import requests
response = requests.post(
'https://api.apiframe.ai/v2/images/generate',
headers={
'X-API-Key': 'afk_your_api_key_here',
'Content-Type': 'application/json',
},
json={
'prompt': 'a futuristic city skyline at sunset, cyberpunk style',
'model': 'midjourney',
},
)
data = response.json()
print(data) # {'jobId': 'abc-123', 'status': 'QUEUED'}4단계: 결과 폴링하기
요청은 즉시 jobId를 반환합니다. 이 ID를 사용해 작업이 COMPLETED 상태가 될 때까지 상태를 확인하세요.
javascriptpoll-job.js
const status = await fetch(
'https://api.apiframe.ai/v2/jobs/abc-123',
{ headers: { 'X-API-Key': 'afk_your_api_key_here' } }
);
const job = await status.json();
// job.status: 'QUEUED' | 'PROCESSING' | 'COMPLETED' | 'FAILED'
// job.result.images: array of CDN URLs when COMPLETED
console.log(job.result.images);작업은 다음과 같은 상태를 거칩니다:
| QUEUED | 작업이 처리 대기 중입니다 |
|---|---|
| PROCESSING | 작업이 처리 중입니다 — 진행률은 progress 필드에서 확인할 수 있습니다 |
| COMPLETED | 결과가 준비되었습니다 — images, videoUrl, tracks 등이 result 필드에 포함됩니다 |
| FAILED | 문제가 발생했습니다 — error 필드를 확인하세요 |
✅
프로덕션 환경에서는 폴링 대신 웹훅을 사용하는 것을 권장합니다. 요청 본문에 webhookUrl과 webhookEvents: ["completed", "failed"]를 추가하면 Apiframe이 결과를 서버로 POST해 줍니다. 자세한 내용은 문서의 Webhooks 가이드를 참고하세요.
생성 가능한 콘텐츠
동일한 작업 기반 패턴이 세 가지 생성 유형 모두에 적용됩니다. 엔드포인트만 바꾸면 됩니다:
| 이미지 | POST /v2/images/generate | midjourney, flux-2-pro, imagen-4, ideogram-v4-quality |
|---|---|---|
| 동영상 | POST /v2/videos/generate | kling-3.0, sora-2, veo-3.1, hailuo-03 |
| 음악 | POST /v2/music/generate | suno, udio, lyria-3-pro |
다음 단계
- 전체 모델 목록은 apiframe.ai/docs에서 확인하세요
- 이미지 편집 엔드포인트(배경 제거, 인페인팅, 업스케일링)도 살펴보세요
- 프로덕션 환경에서는 웹훅을 설정하세요
- Discord 커뮤니티에 참여하세요: discord.gg/pM3qyNAXXC
