문서

인증

모든 API 요청에는 Bearer 토큰을 사용한 인증이 필요합니다.

API 키 사용하기

모든 요청의 Authorization 헤더에 API 키를 포함하세요:

Authorization: Bearer ${RENDERFUL_API_KEY}

Developer API keys typically start with sk_ (legacy keys may start with vega_). Agent keys start with rf_.

요청 예시

curl -X POST https://api.renderful.ai/api/v1/generations \
  -H "Authorization: Bearer ${RENDERFUL_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"type":"text-to-image","model":"flux-dev","prompt":"A sunset"}'

보안 모범 사례

• 클라이언트 측 코드에 API 키를 노출하지 마세요
• 환경 변수를 사용하여 키를 저장하세요
• 주기적으로 키를 교체하세요
• 개발 환경과 프로덕션 환경에 다른 키를 사용하세요

Balance endpoints by key type

Use the balance endpoint that matches the key prefix you are authenticating with.

Key Type	Prefix	Balance Endpoint
Developer API key	sk_ / vega_	GET /api/v1/account/balance
Agent API key	rf_	GET /api/v1/agents/balance

Query developer balance

curl -X GET https://api.renderful.ai/api/v1/account/balance \
  -H "Authorization: Bearer sk_your_api_key"

API 키 형식

Renderful API 키는 쉽게 식별할 수 있도록 특정 형식을 따릅니다:

접두사	설명
sk_	Developer API key for dashboard-created server-side integrations
vega_	Legacy developer API key format still accepted for existing integrations
rf_	Agent API key returned by `POST /api/v1/agents/register`