End-Customer Budgets

curl https://api.core.today/v1/reseller/status \
  -H "X-API-Key: cdt_your_api_key"

# Response — reseller_mode가 false여도 필드 구성은 동일합니다
{
  "reseller_mode": true,
  "customer_count": 3,
  "max_customers": 10000,
  "workspace_credits": 5000.0,
  "committed_cap": 12000.0,
  "overcommit_ratio": 2.4,
  "overcommitted": true
}

curl -X POST https://api.core.today/v1/reseller/customers \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
    "customer_id": "user_abc123",
    "cap": 2000,
    "name": "Acme Corp",
    "external_ref": "optional-your-internal-ref"
  }'

# Response (201 Created)
{
  "customer_id": "user_abc123",
  "cap": 2000,
  "spent": 0,
  "remaining": 2000,
  "status": "active",
  "name": "Acme Corp",
  "external_ref": "optional-your-internal-ref",
  "monthly_allowance": null,
  "next_reset_at": null,
  "reset_due": false,
  "created_at": "2026-07-01T00:00:00+00:00",
  "updated_at": "2026-07-01T00:00:00+00:00"
}

curl -X PATCH https://api.core.today/v1/reseller/customers/user_abc123 \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{ "name": "Acme Corp (renamed)", "external_ref": "crm-4412" }'

# Response — full wallet (remaining = cap - spent)
{
  "customer_id": "user_abc123",
  "cap": 2000,
  "spent": 350,
  "remaining": 1650,
  "status": "active",
  "name": "Acme Corp (renamed)",
  "external_ref": "crm-4412",
  "monthly_allowance": null,
  "next_reset_at": null,
  "reset_due": false
}

docs.endCustomerBudgets.step3.bulkCode

# 이미지 생성 요청 (고객 예산 적용)
curl -X POST https://api.core.today/v1/predictions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -H "X-Customer-Id: user_abc123" \
  -d {
    "model": "black-forest-labs/flux-schnell",
    "input": {
      "prompt": "A futuristic city skyline"
    }
  }

# LLM/chat 요청 (게이트웨이 경유) — 고객 예산이 동일하게 적용됩니다
curl -X POST https://api.core.today/llm/openai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -H "X-Customer-Id: user_abc123" \
  -d {
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "Hello!"}]
  }

curl -X POST https://api.core.today/v1/reseller/customers/user_abc123/topup \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
    "amount": 1000,
    "idempotency_key": "topup-2026-06-30-001"
  }'

# Response
{
  "applied": true,
  "cap": 3000
}

docs.endCustomerBudgets.step5.bulkCode

# 잔액 조회
curl https://api.core.today/v1/reseller/customers/user_abc123 \
  -H "X-API-Key: cdt_your_api_key"

# Response — 월간 예산 3필드 포함 (monthly_allowance, next_reset_at, reset_due)
{
  "customer_id": "user_abc123",
  "cap": 3000,
  "spent": 450,
  "remaining": 2550,
  "status": "active",
  "external_ref": null,
  "monthly_allowance": null,
  "next_reset_at": null,
  "reset_due": false
}

# 전체 목록 조회 (커서 페이지네이션, limit 1..500 기본 100)
curl "https://api.core.today/v1/reseller/customers?limit=100" \
  -H "X-API-Key: cdt_your_api_key"

# Response — next_cursor가 null이면 마지막 페이지
{
  "items": [
    {
      "customer_id": "user_abc123",
      "cap": 3000,
      "spent": 450,
      "status": "active",
      "external_ref": null,
      "monthly_allowance": null,
      "next_reset_at": null,
      "reset_due": false,
      ...
    }
  ],
  "next_cursor": "eyJQSyI6...opaque..."
}

# 다음 페이지 — 받은 next_cursor를 그대로 cursor로 전달
curl "https://api.core.today/v1/reseller/customers?cursor=eyJQSyI6...opaque...&limit=100" \
  -H "X-API-Key: cdt_your_api_key"

# 고객 삭제 (소프트 삭제 → 204 No Content)
curl -X DELETE https://api.core.today/v1/reseller/customers/user_abc123 \
  -H "X-API-Key: cdt_your_api_key"

# 고객 일시 정지
curl -X POST https://api.core.today/v1/reseller/customers/user_abc123/suspend \
  -H "X-API-Key: cdt_your_api_key"

# Response
{
  "customer_id": "user_abc123",
  "status": "suspended"
}

# 고객 재개
curl -X POST https://api.core.today/v1/reseller/customers/user_abc123/reactivate \
  -H "X-API-Key: cdt_your_api_key"

# Response
{
  "customer_id": "user_abc123",
  "status": "active"
}

docs.endCustomerBudgets.step8.code

# 원시 사용 내역 (limit 1..1000, 기본 100, 최신순)
curl "https://api.core.today/v1/reseller/customers/user_abc123/usage?limit=20" \
  -H "X-API-Key: cdt_your_api_key"

# Response — usage 로그 원본 레코드 (주요 필드)
{
  "records": [
    {
      "timestamp": "2026-06-30T11:00:00Z",
      "provider": "black-forest-labs",
      "model": "flux-schnell",
      "credits_used": 10,
      "final_status": "completed",
      "job_id": "job_xxx",
      ...
    }
  ]
}

# 특정 고객의 기간 집계
curl "https://api.core.today/v1/reseller/customers/user_abc123/usage/summary?start_date=2026-06-01T00:00:00Z&end_date=2026-07-01T00:00:00Z" \
  -H "X-API-Key: cdt_your_api_key"

# Response
{
  "customer_id": "user_abc123",
  "total_credits": 42.5,
  "total_requests": 3,
  "failed_requests": 1,
  "by_model": [
    { "model": "flux-schnell", "credits": 42.5, "count": 3 }
  ]
}

# 워크스페이스 전체 고객 집계 (rollup)
curl "https://api.core.today/v1/reseller/usage/summary?start_date=2026-06-01T00:00:00Z&end_date=2026-07-01T00:00:00Z" \
  -H "X-API-Key: cdt_your_api_key"

# Response
{
  "customers": [
    { "customer_id": "user_abc123", "credits": 42.5, "count": 3, "failed": 1 }
  ],
  "total_credits": 42.5,
  "total_requests": 3,
  "failed_requests": 1
}

# 정산용 CSV 다운로드 (헤더: customer_id,credits,requests,failed_requests)
curl "https://api.core.today/v1/reseller/usage/summary?format=csv" \
  -H "X-API-Key: cdt_your_api_key" \
  -o billing.csv

# 일 단위 breakdown (group_by=day) — 두 summary 엔드포인트 모두 지원 (JSON 전용)
curl "https://api.core.today/v1/reseller/usage/summary?start_date=2026-06-01T00:00:00Z&end_date=2026-07-01T00:00:00Z&group_by=day" \
  -H "X-API-Key: cdt_your_api_key"

# Response에 by_day 배열이 추가됨
{
  "customers": [...],
  "total_credits": 42.5,
  "total_requests": 3,
  "failed_requests": 1,
  "by_day": [
    { "date": "2026-06-01", "credits": 12.5, "count": 1, "failed": 0 },
    { "date": "2026-06-02", "credits": 30.0, "count": 2, "failed": 1 }
  ]
}

# 단일 고객 검증
curl https://api.core.today/v1/reseller/customers/user_abc123/reconcile \
  -H "X-API-Key: cdt_your_api_key"

# Response
{
  "customer_id": "user_abc123",
  "meter_spent": 450.0,
  "usage_credits": 450.0,
  "drift": 0.0,
  "in_sync": true
}

# 워크스페이스 전체 검증 (limit 1..1000, 기본 500)
curl "https://api.core.today/v1/reseller/reconcile?limit=1000" \
  -H "X-API-Key: cdt_your_api_key"

# Response — drift가 있는 고객만 반환
{
  "checked": 42,
  "in_sync": 41,
  "drifted": [
    {
      "customer_id": "user_xyz",
      "meter_spent": 120.0,
      "usage_credits": 100.0,
      "drift": 20.0
    }
  ],
  "truncated": false
}

curl "https://api.core.today/v1/reseller/customers/user_abc123/files?limit=20" \
  -H "X-API-Key: cdt_your_api_key"

# Response
{
  "files": [
    {
      "object_key": "aiapi/team123/outputs/1734175200000_result.png",
      "filename": "result.png",
      "folder": "outputs",
      "content_type": "image/png",
      "file_size": 1048576,
      "uploaded_at": "2026-07-10T11:00:00Z",
      "job_id": "job_xxx",
      "source": "ai_output",
      "url": "https://files.core.today/aiapi/...&Expires=...",
      "expires_at": "2026-07-17T11:00:00Z"
    }
  ],
  "next_cursor": null
}

// Node.js — npm install @coredot/aiapi
import { AIAPI } from "@coredot/aiapi";

const client = new AIAPI({ apiKey: "cdt_your_api_key" });
await client.reseller.createCustomer({ customer_id: "user_abc123", cap: 1000 });
await client.predictions.create({
  model: "black-forest-labs/flux-schnell",
  input: { prompt: "hello" },
  customerId: "user_abc123",
});

# Python — pip install coredot-aiapi
from aiapi import AIAPI

client = AIAPI(api_key="cdt_your_api_key")
client.reseller.create_customer(customer_id="user_abc123", cap=1000)
client.predictions.create(
    model="black-forest-labs/flux-schnell",
    input={"prompt": "hello"},
    customer_id="user_abc123",
)