LogoWan API 문서
홈페이지
X (Twitter)
홈페이지

시작하기

개요연동 가이드잔액 확인작업 삭제

Wan 모델

Wan 3.0Wan 3.0 PrimeWan 3.0 ProWan 3.0 Prime Pro

Seedance 모델

Seedance 2.5Seedance 2.5 FlashSeedance 2.0Seedance 2.0 FastSeedance 2.0 Mini

이미지 모델

Seedream 5.0 ProSeedream 5.5 API

언어 모델

Claude APIClaude Haiku 5.5Claude Sonnet 5.5Claude Opus 5.5Claude Fable 5.2GPT APIGPT Luna 6GPT Terra 6.1GPT Sol 6.1GPT Astra 6
X (Twitter)

GPT Astra 6 API

GPT Astra 6 API: 텍스트·이미지 입력, 추론 설정, 스트리밍 예제와 그룹별 실시간 토큰 요금.

Wan API 키로 OpenAI Responses 또는 Chat Completions 형식을 사용해 GPT Astra 6를 호출하세요. GPT 모델 비교.

모델 설정

설정GPT Astra 6
요청 모델 IDgpt-6-astra
입력 / 출력텍스트와 이미지 / 텍스트
컨텍스트 윈도1,050,000 토큰
최대 입력922,000 토큰
최대 출력추론을 포함한 128,000 토큰
추론 강도low, medium, high, xhigh, max
기본 추론 강도직접 지정

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

연결 및 요청 전송

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

curl https://api.wanapi.app/v1/responses \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-astra",
    "input": "Explain the purpose of a database index in three sentences.",
    "reasoning": {"effort": "low"},
    "max_output_tokens": 1024
  }'
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-astra",
    input="Explain the purpose of a database index in three sentences.",
    reasoning={"effort": "low"},
    max_output_tokens=1024,
)
print(response.output_text)

Responses 매개변수

필드필수규격
model예gpt-6-astra.
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아니요업스트림에서 지원하는 기본 컨텍스트 또는 저장된 프롬프트 설정.

추론 및 도구

Astra는 항상 추론하며 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 지원 범위

게이트웨이는 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을 사용하세요. 사용자 입력 항목에 이미지와 질문을 함께 넣으세요.

{"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

curl https://api.wanapi.app/v1/chat/completions \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-astra",
    "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 Astra 6

gpt-6-astra

GPT Astra 6 — 토큰 100만 개당 USD
과금 대상 토큰gpt · 기본gpt-0.7
입력 토큰 ≤ 272,000입력 토큰 > 272,000입력 토큰 ≤ 272,000입력 토큰 > 272,000
입력(캐시되지 않음)US$1US$2US$7US$14
출력US$5US$7.5US$35US$52.5
캐시 읽기US$0.1US$0.2US$0.7US$1.4
캐시 쓰기US$1.25US$2.5US$8.75US$17.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 로그에는 최근 7일간 완료된 호출의 모델, 입력 토큰, 출력 토큰, 비용이 표시됩니다. gpt-6-astra로 필터링하세요. 이미지와 동영상은 작업 로그를 사용합니다.

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

모델 참고 자료

  • GPT Astra 6 공식 사양
  • Responses 참고 문서
  • GPT 모델 및 추론

GPT Sol 6.1

GPT Sol 6.1 API: 텍스트·이미지 입력, 추론 설정, 스트리밍 예제와 그룹별 실시간 토큰 요금.

목차

모델 설정연결 및 요청 전송Responses 매개변수추론 및 도구현재 API 지원 범위이미지 입력Chat Completions요금응답 및 스트리밍사용 로그 및 오류모델 참고 자료