# GPU Console API 시작하기

기본 주소는 `https://gpu.taek.cc`입니다. API 키는 `Authorization: Bearer <API 키>`로 전달합니다. 아래 예제는 `GPU_CONSOLE_URL`과 `GPU_CONSOLE_API_KEY` 환경변수를 사용합니다.

## 먼저 할 일

1. 콘솔에서 필요한 범위의 API 키를 만듭니다.
2. 모델 목록에서 모델 ID와 실행 위치·준비 상태를 확인합니다.
3. 작업을 호출합니다. 이미지·로컬 음성은 접수한 작업 ID로 결과를 조회합니다.

```sh
export GPU_CONSOLE_URL=https://gpu.taek.cc
# GPU_CONSOLE_API_KEY는 사용하는 프로그램의 비공개 환경변수로 설정합니다.
curl "$GPU_CONSOLE_URL/v1/models" \
  -H "Authorization: Bearer $GPU_CONSOLE_API_KEY"
```

## 어떤 API를 사용하나요?

| 원하는 작업 | 모델·준비 상태 확인 | 호출 | 필요한 키 범위 |
| --- | --- | --- | --- |
| LLM 대화 | `/v1/models` | `/v1/chat/completions` | chat |
| Anthropic 형식 대화 | `/v1/models`의 지원 경로 | `/v1/messages` | messages |
| 로컬 이미지·영상·음성 | `/v1/media/models` | `/v1/media/jobs` | images / videos / audio_stt / audio_tts |
| Codex 구독 이미지 | `/v1/images/status` | `/v1/images/jobs` | images |

모델 ID가 실행 위치를 결정합니다. 로컬 모델은 등록한 GPU에 고정되고 Codex 이미지는 홈서버에서 실행됩니다. 로컬 작업은 관리자 화면에서 해당 GPU의 이미지·음성 API 모드와 모델 설치를 준비해야 합니다. 생성 키로 장비를 중지하거나 모드를 바꿀 수는 없습니다.

## 생성·인식은 접수와 완료가 다릅니다

`POST`가 HTTP202와 `id`, `status_url`을 반환하면 접수된 것입니다. `status_url`을 조회해 `succeeded`가 된 뒤 `file_url` 또는 `image_url`로 결과를 다운로드합니다. 상태 조회에는 같은 자격을 보냅니다. 이미지 결과는 기본 공개·무제한 URL이므로 브라우저에서 바로 열 수 있습니다. 음성·비공개 결과는 인증이 필요합니다.

`queued`, `running`, `cancelling`은 진행 중입니다. `failed`, `cancelled`, `unknown`은 성공이 아닙니다. 실패 이유는 `error.code`와 `error.message`를 확인합니다. Codex의 추가 설명은 `error.provider_note`에 있을 수 있습니다.

같은 논리적 요청의 네트워크 재확인에는 같은 `Idempotency-Key`와 같은 본문을 사용합니다. 새 키를 만들면 새 생성 작업이 될 수 있습니다. 응답을 잃었을 때 자동으로 새 작업을 만들지 마세요.

## 문서 선택과 복사

상단에서 LLM·이미지·음성·운영/관리를 선택하면 해당 작업에 필요한 안내만 보입니다. **LLM용 문서 복사**도 선택한 안내만 복사합니다. 모든 관리·내부 경로가 필요한 경우에만 **전체 참고**를 선택하세요.

문서에는 실제 키·계정·장비 상태가 포함되지 않습니다. `/llms.txt`는 문서 색인, `/llms-full.txt?topic=images` 등은 작업별 안내, `/llms-full.txt`는 전체 참고 문서입니다.