# GPT Sol 6.1 API (https://wanapi.app/ko/docs/gpt-6-1-sol)





Wan API 키로 OpenAI Responses 또는 Chat Completions 형식을 사용해 **GPT Sol 6.1**를 호출하세요. [GPT 모델 비교](/ko/docs/gpt-api).

## 모델 설정 [#모델-설정]

| 설정       | GPT Sol 6.1                             |
| -------- | --------------------------------------- |
| 요청 모델 ID | `gpt-6.1-sol`                           |
| 입력 / 출력  | 텍스트와 이미지 / 텍스트                          |
| 컨텍스트 윈도  | 1,050,000 토큰                            |
| 최대 입력    | 922,000 토큰                              |
| 최대 출력    | 추론을 포함한 128,000 토큰                      |
| 추론 강도    | `low`, `medium`, `high`, `xhigh`, `max` |
| 기본 추론 강도 | medium                                  |

위 수치는 모델 자체의 한도입니다. 요청에는 사용 가능한 채널과 계정의 한도도 적용됩니다. 오디오와 동영상 입력은 지원하지 않습니다.

## 연결 및 요청 전송 [#연결-및-요청-전송]

[API 키 설정](/ko/settings/apikeys)에서 키를 생성하고 서버에 `WAN_API_KEY`로 보관하세요. 하나의 키와 동일한 선불 잔액으로 여러 모델과 그룹을 이용할 수 있습니다. 6.1의 소수점을 포함해 정확한 모델 ID를 사용하세요.

```bash
curl https://api.wanapi.app/v1/responses \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6.1-sol",
    "input": "Explain the purpose of a database index in three sentences.",
    "reasoning": {"effort": "low"},
    "max_output_tokens": 1024
  }'
```

```python
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["WAN_API_KEY"],
    base_url="https://api.wanapi.app/v1",
)
response = client.responses.create(
    model="gpt-6.1-sol",
    input="Explain the purpose of a database index in three sentences.",
    reasoning={"effort": "low"},
    max_output_tokens=1024,
)
print(response.output_text)
```

## Responses 매개변수 [#responses-매개변수]

| 필드                                                                   | 필수  | 규격                                                    |
| -------------------------------------------------------------------- | --- | ----------------------------------------------------- |
| `model`                                                              | 예   | `gpt-6.1-sol`.                                        |
| `input`                                                              | 예   | 프롬프트 문자열 또는 입력 항목 배열.                                 |
| `instructions`                                                       | 아니요 | 시스템 또는 개발자 지침.                                        |
| `max_output_tokens`                                                  | 아니요 | 추론을 포함한 출력 예산. 최대 128,000 토큰.                         |
| `reasoning.effort`                                                   | 아니요 | low, medium, high, xhigh, max.                        |
| `reasoning.summary`                                                  | 아니요 | `auto`, `concise`, `detailed`.                        |
| `text.verbosity`                                                     | 아니요 | `low`, `medium`, `high`.                              |
| `text.format`                                                        | 아니요 | 텍스트 또는 지원되는 JSON Schema와 같은 구조화된 출력.                  |
| `stream`                                                             | 아니요 | `true`이면 SSE를 사용하고, 그 외에는 완전한 응답을 반환합니다.              |
| `tools`, `tool_choice`                                               | 아니요 | 도구 선언과 선택. 클라이언트 함수는 애플리케이션에서 실행합니다.                  |
| `parallel_tool_calls`, `max_tool_calls`                              | 아니요 | 지원되는 경우 도구 동시 실행과 호출 횟수 제한.                           |
| `include`                                                            | 아니요 | 추가 응답 필드. 예: `reasoning.encrypted_content`.           |
| `metadata`, `store`                                                  | 아니요 | 메타데이터와 응답 저장 설정.                                      |
| `previous_response_id`                                               | 아니요 | 이전 응답 ID. 요청을 처리하는 업스트림에서 해당 응답에 접근할 수 있는 동안에만 유효합니다. |
| `truncation`                                                         | 아니요 | 입력 잘라내기 정책.                                           |
| `prompt_cache_key`, `prompt_cache_retention`, `prompt_cache_options` | 아니요 | 채널에서 지원하는 캐시 라우팅과 보관 설정.                              |
| `reasoning.mode`, `reasoning.context`                                | 아니요 | 업스트림으로 전달되며 모델별 제한이 적용됩니다. 워크플로에 필요한 경우가 아니면 생략하세요.   |
| `context_management`, `conversation`, `prompt`                       | 아니요 | 업스트림에서 지원하는 기본 컨텍스트 또는 저장된 프롬프트 설정.                   |

## 추론 및 도구 [#추론-및-도구]

Sol은 항상 추론하며 `none`과 `minimal`을 지원하지 않습니다. 도구 호출에는 Responses API가 필요합니다.

추론이 활성화되어 있으면 `temperature`, `top_p`, `top_logprobs`를 생략하세요. Chat Completions에서는 `logprobs`도 생략하고, Responses에서는 `include`에 `message.output_text.logprobs`를 요청하지 마세요.

출력 예산에는 추론과 표시되는 텍스트가 모두 포함됩니다. 답변이 완성되기 전에 출력 한도에 도달할 수 있습니다. 추론 강도가 높으면 더 많은 출력 토큰과 시간이 필요할 수 있습니다.

구조화된 출력에는 `type: "json_schema"`, 이름, 모델이 지원하는 스키마를 포함한 `text.format`을 사용하세요. 스키마는 형식을 제한하지만 사실의 정확성을 보장하지는 않습니다. 도구 대화를 이어갈 때는 원래 호출 ID와 함께 클라이언트 함수 결과를 반환하세요.

## 현재 API 지원 범위 [#현재-api-지원-범위]

게이트웨이는 `POST /v1/responses`와 `POST /v1/chat/completions`를 받습니다. 모델 사용 가능 여부는 설정된 채널에 따라 달라집니다. 연동 전에 인증된 `GET /v1/models`로 확인하세요. 아래에 요금이 표시되지 않는다고 해서 모델을 호출할 준비가 되었다는 뜻은 아닙니다.

호환 계층은 임의의 JSON 전체가 아닌, 인식하는 필드만 전달합니다. 현재 Responses DTO에는 API 고유의 `access_programs`, `image`, `background` 필드가 없습니다. 무시된 필드가 적용되었다고 가정하지 마세요. 채널 설정에 따라 `service_tier`와 `safety_identifier`도 필터링될 수 있습니다.

이 연동에서는 Files API, Batch API 또는 백그라운드 응답 폴링을 제공하지 않습니다. 동기 응답이나 SSE를 사용하세요. 내장 도구는 업스트림의 지원 여부에 따라 달라지며 별도 요금이 발생할 수 있습니다. 도구를 선언했다고 해서 전체 도구 세션을 여기서 사용할 수 있다는 뜻은 아닙니다.

## 이미지 입력 [#이미지-입력]

직접 호스팅하는 공개 접근 가능한 HTTP(S) 이미지 URL을 사용하세요. 사용자 입력 항목에 이미지와 질문을 함께 넣으세요.

```json
{"role":"user","content":[
  {"type":"input_image","image_url":"https://example.com/chart.png"},
  {"type":"input_text","text":"What does this chart show?"}
]}
```

예시 URL을 본인의 이미지 URL로 바꾸세요. 이 연동에서는 업로드나 미디어 저장 서비스를 제공하지 않습니다.

## Chat Completions [#chat-completions]

```bash
curl https://api.wanapi.app/v1/chat/completions \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6.1-sol",
    "messages": [{"role":"user","content":"Explain what a database index does."}],
    "reasoning_effort": "low",
    "max_completion_tokens": 1024
  }'
```

`choices[0].message.content`에서 텍스트를 읽으세요. Chat Completions는 `messages`, `reasoning_effort`, `max_completion_tokens`를 사용하고, Responses는 `input`, `reasoning.effort`, `max_output_tokens`를 사용합니다. Chat Completions의 이미지 메시지에는 `type: "image_url"`과 `image_url: {"url":"https://..."}`를 사용하세요.

## 요금 [#요금]

토큰 100만 개당 USD

현재 요금에는 각 그룹의 배율이 반영되어 있습니다. 요금은 최대 2분 동안 캐시됩니다.

하나의 API 키로 모든 모델과 그룹을 이용할 수 있습니다. 기본 표시는 자동 라우팅 순서에서 가장 먼저 이용 가능한 그룹을 뜻하며, 실제로 선택된 그룹의 요금이 적용됩니다.

### GPT Sol 6.1

`gpt-6.1-sol`

| 과금 대상 토큰 | gpt · 기본 · 입력 토큰 ≤ 272,000 | gpt · 기본 · 입력 토큰 > 272,000 | gpt-0.7 · 입력 토큰 ≤ 272,000 | gpt-0.7 · 입력 토큰 > 272,000 |
| --- | ---: | ---: | ---: | ---: |
| 입력(캐시되지 않음) | US$0.2 | US$0.4 | US$1.4 | US$2.8 |
| 출력 | US$1 | US$1.5 | US$7 | US$10.5 |
| 캐시 읽기 | US$0.01 | US$0.02 | US$0.07 | US$0.14 |
| 캐시 쓰기 | US$0.25 | US$0.5 | US$1.75 | US$3.5 |

구간 기준: 캐시된 입력을 포함한 전체 입력 토큰 수. 선택된 구간은 기준을 초과한 토큰만이 아닌 요청 전체에 적용됩니다.

—는 확인된 요금이 없다는 뜻이며, 무료를 의미하지 않습니다.

캐시 요금은 응답에 해당 캐시 사용량이 보고된 경우에만 적용됩니다. 캐시된 토큰을 캐시되지 않은 입력으로 다시 계산하지 마세요.

각 과금 대상 토큰 수에 해당 요율을 곱한 뒤 1,000,000으로 나누세요. 추론 토큰은 출력 토큰에 포함되며 별도로 중복 과금하지 않습니다. 캐시된 입력을 캐시되지 않은 입력으로 다시 계산하면 안 됩니다. 응답에 보고된 캐시 사용량만 사용하세요. 표의 캐시 쓰기 항목이 모든 보관 모드의 지원을 의미하지는 않습니다.

입력 길이에 따른 요금은 해당 구간의 요율을 요청 전체에 적용합니다. 고정 요율을 가정하지 말고 표의 기준값과 입력 계산 기준을 확인하세요. 그룹 헤더를 생략한 요청은 `gpt`를 사용합니다. Responses 또는 Chat Completions에서 그룹을 선택하려면 `X-Model-Group: gpt` 또는 `X-Model-Group: gpt-0.7`을 전송하세요. `gpt-0.7`은 Luna, Sol, Astra에서만 사용할 수 있으며 Terra는 `gpt`만 지원합니다. 명시적으로 선택한 그룹에서 다른 그룹으로 자동 전환하지 않습니다. 모델 ID는 그대로 유지하세요. 그룹 접미사는 지원하지 않습니다.

## 응답 및 스트리밍 [#응답-및-스트리밍]

완료된 Responses 결과에는 `id`, `model`, `status`, `output`, `usage`가 포함됩니다. `output`에는 추론, 도구 호출, 메시지가 들어갈 수 있으므로 첫 항목이 텍스트라고 가정하지 마세요. OpenAI SDK의 `output_text` 헬퍼로 텍스트 출력을 모을 수 있습니다.

SSE를 사용하려면 `stream: true`를 설정하고 `curl -N`을 사용하세요. `response.created`, `response.output_text.delta`, `response.completed`, 미완료 응답, 오류를 처리해야 합니다. 최종 응답에는 사용량이 포함됩니다. Chat Completions는 `choices[].delta`를 스트리밍합니다. 마지막 사용량 청크를 받으려면 `stream_options: {"include_usage":true}`를 요청하세요.

## 사용 로그 및 오류 [#사용-로그-및-오류]

[LLM 로그](/ko/usage)에는 최근 7일간 완료된 호출의 모델, 입력 토큰, 출력 토큰, 비용이 표시됩니다. `gpt-6.1-sol`로 필터링하세요. 이미지와 동영상은 [작업 로그](/ko/tasks)를 사용합니다.

실패하면 HTTP 상태와 `error` 객체를 확인하세요. 키, [잔액](/ko/docs/balance), 정확한 모델 ID, 매개변수 조합을 점검하세요. 요청이나 스트림이 끊긴 경우 재시도 전에 로그를 확인하세요. 새 요청에는 추가 요금이 발생할 수 있습니다.

## 모델 참고 자료 [#모델-참고-자료]

* [GPT Sol 6.1 공식 사양](https://developers.openai.com/api/docs/models/gpt-6.1-sol)
* [Responses 참고 문서](https://developers.openai.com/api/reference/resources/responses/methods/create)
* [GPT 모델 및 추론](https://developers.openai.com/api/docs/guides/latest-model)
