엔드포인트
생성 조회
GET /generation에 생성 ID를 전달해 지난 요청의 정확한 비용, 토큰 수, 제공자, 지연 시간, 종료 사유를 확인하는 방법과 ID를 찾는 위치, 반영 시간, 오류를 설명합니다. 비용이 반영되기까지 걸리는 시간도 알려 줍니다.
생성 ID로 지난 요청의 세부 정보(정확한 비용, 토큰 수, 제공자, 지연 시간, 종료 사유)를 조회합니다. 청구서 대조, 스트리밍 요청 감사, 느린 호출 디버깅에 유용합니다.
GET https://api14.com/api/v1/generation?id={generation_id}
ID를 찾을 수 있는 곳
- 채팅 완성, 완성(completion) 또는 응답의
id필드(gen-...). - 있는 경우
X-Generation-Id응답 헤더. - 스트림의 첫 번째 청크에 있는
id. - 대시보드의 사용량 페이지.
요청
| 쿼리 파라미터 | 필수 | 설명 |
|---|---|---|
id | 예 | 생성 ID. |
curl "https://api14.com/api/v1/generation?id=gen-1791100000-abc123" \
-H "Authorization: Bearer sk-api14-..."
본인 계정에서 만든 생성만 조회할 수 있습니다. 그 밖의 ID(또는 기록된 적 없는 ID)는 404 not_found를 반환합니다.
응답
본문은 생성 기록입니다.
{
"data": {
"id": "gen-1791100000-abc123",
"model": "anthropic/claude-sonnet-4.5",
"created_at": "2026-10-04T09:12:44Z",
"provider_name": "Anthropic",
"streamed": true,
"finish_reason": "stop",
"tokens_prompt": 1250,
"tokens_completion": 340,
"native_tokens_prompt": 1310,
"native_tokens_completion": 352,
"native_tokens_reasoning": 0,
"native_tokens_cached": 1024,
"latency": 412,
"generation_time": 3810,
"total_cost": 0.00918
}
}
| 필드 | 설명 |
|---|---|
total_cost | 잔액에서 차감된 금액(USD). |
native_tokens_* | 제공자 자체 토크나이저로 센 토큰 수이며, 실제 과금 기준입니다. |
native_tokens_cached | 캐시에서 제공된 프롬프트 토큰. 프롬프트 캐싱을 참고하세요. |
latency / generation_time | 첫 토큰까지의 시간과 전체 생성 시간(ms). |
비용
total_cost(원래 응답의 usage.cost도 같음)는 해당 요청에 대한 청구 금액이며, 사용량 페이지에 표시되는 금액과 같습니다. 요금 및 결제를 참고하세요.
반영 시간
요청이 끝난 뒤 기록이 나타나기까지 몇 초가 걸릴 수 있습니다. 요청 직후 404가 나오면 잠시 후 다시 시도하세요.
오류
| 상태 | 코드 | 발생 조건 |
|---|---|---|
| 401 | invalid_api_key | 키가 없거나 유효하지 않습니다. |
| 404 | not_found | 알 수 없는 ID이거나 다른 계정의 ID입니다. |
| 502 | upstream_unavailable | 기록을 가져오지 못했습니다. 다시 시도하세요. |
오류를 참고하세요.