Getting Started

Core.Today AI API를 사용하여 다양한 AI 모델에 접근하세요.

API 키 발급

대시보드의 API Keys 메뉴에서 새 API 키를 생성하세요.

중요: API 키는 생성 시 한 번만 표시됩니다. 안전한 곳에 보관하세요.

인증 방식

모든 API 요청에 API 키를 포함해야 합니다:

# 방법 1: X-API-Key 헤더 (권장)
curl -H "X-API-Key: cdt_your_api_key" ...

# 방법 2: Authorization 헤더
curl -H "Authorization: Bearer cdt_your_api_key" ...

크레딧 시스템

무료 크레딧

매일 50 크레딧 자동 충전 (UTC 자정)

충전

충전 코드로 추가 크레딧 구매 가능

API 개요

서비스	Base URL	용도
Image/Video API	https://api.core.today/v1	이미지 생성, 비디오 생성
LLM API	https://api.core.today/llm	ChatGPT, Claude, Gemini

기본 요청 구조

curl -X POST https://api.core.today/v1/predictions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
    "model": "flux-schnell",
    "input": {
      "prompt": "A beautiful sunset over mountains"
    },
    "is_public": false,
    "output_folder": "my-project/images"
  }'

파라미터	타입	필수	설명
model	string	Yes	모델 ID (예: flux-schnell, seedream-4)
input	object	Yes	모델별 입력 파라미터
is_public	boolean	No	true 시 영구 public URL 생성 (기본값: false)
output_folder	string	No	결과물 저장 폴더 (예: my-project/images)

결과물 저장 경로 지정

output_folder 옵션으로 AI 생성 결과물의 저장 경로를 지정할 수 있습니다.

기본 저장 경로

aiapi/{api_key_hash}/{job_id}/o/

커스텀 저장 경로

aiapi/{api_key_hash}/{output_folder}/

폴더 경로 규칙

• 슬래시(/)로 하위 폴더 구분 가능 (예: 2024/12/outputs)
• 시작/끝 슬래시는 자동 제거됨
• .. (상위 디렉토리) 사용 불가
• 최대 256자

사용 예시

# 프로젝트별 폴더로 결과물 정리
{
  "model": "flux-schnell",
  "input": {"prompt": "product photo"},
  "output_folder": "ecommerce/product-images"
}

# 날짜별 폴더로 정리
{
  "model": "flux-schnell",
  "input": {"prompt": "landscape"},
  "output_folder": "daily/2024/12/15"
}