텍스트 모델고급 사용자업데이트
POST/v1/messages
Qwen 3.8 Flash
요청 ID qwen3.8-flash
프로토콜
POST /v1/messages· Anthropic Messages 예시POST /v1/chat/completions· Chat Completions 예시POST /v1/responses· OpenAI Responses 예시
인증
요청에는 API 키 관리의 API 키가 필요합니다. JSON 요청은 Content-Type: application/json을 지정하세요.
- Anthropic Messages ·
x-api-key: YOUR_API_KEY Authorization: Bearer YOUR_API_KEY
요청 매개변수
POST /v1/messages
| 필드 | 유형 | 필수 여부 | 설명 |
|---|---|---|---|
model | string | 필수 | 모델 ID를 qwen3.8-flash로 설정하세요. |
messages | object[] | 필수 | user와 assistant 메시지를 순서대로 보내세요. 시스템 지침은 최상위 system에 넣습니다. |
messages[].content | string / object[] | 필수 | 메시지 본문입니다. 일반 텍스트 또는 프로토콜에서 정의한 콘텐츠 블록 배열을 사용합니다. |
system | string / object[] | 선택 | 시스템 지침입니다. 텍스트 또는 텍스트 블록 배열로 전달합니다. |
max_tokens | integer | 필수 | 출력 토큰 수의 상한입니다. 허용 범위는 모델과 엔드포인트에 따라 다릅니다. |
stream | boolean | 선택 | true는 SSE 스트리밍, false는 일반 JSON 응답을 요청합니다. 지원 모드는 엔드포인트에 따라 다릅니다. |
temperature | number | 조건부 | 샘플링의 무작위성을 조절합니다. 허용값과 적용 여부는 모델 및 엔드포인트에 따라 다릅니다. |
top_p | number | 조건부 | 누적 확률로 샘플링 후보를 제한합니다. 모델과 엔드포인트에서 지원할 때 사용하세요. |
POST /v1/chat/completions
| 필드 | 유형 | 필수 여부 | 설명 |
|---|---|---|---|
model | string | 필수 | 모델 ID를 qwen3.8-flash로 설정하세요. |
messages | object[] | 필수 | 대화 순서대로 메시지를 보냅니다. 각 메시지에는 role과 content가 들어갑니다. |
messages[].content | string / object[] | 조건부 | 메시지 본문입니다. 일반 텍스트 또는 프로토콜에서 정의한 콘텐츠 블록 배열을 사용합니다. |
stream | boolean | 선택 | true는 SSE 스트리밍, false는 일반 JSON 응답을 요청합니다. 지원 모드는 엔드포인트에 따라 다릅니다. |
max_completion_tokens | integer | 조건부 | 해당하는 추론 토큰을 포함한 생성 토큰 수의 상한입니다. 이 필드를 지원하는 엔드포인트에서 사용하세요. |
max_tokens | integer | 조건부 | 출력 토큰 제한을 위한 호환 필드입니다. 엔드포인트에 따라 이 필드와 max_completion_tokens 중 하나를 사용하세요. |
temperature | number | 조건부 | 샘플링의 무작위성을 조절합니다. 허용값과 적용 여부는 모델 및 엔드포인트에 따라 다릅니다. |
top_p | number | 조건부 | 누적 확률로 샘플링 후보를 제한합니다. 모델과 엔드포인트에서 지원할 때 사용하세요. |
response_format | object | 조건부 | 구조화된 출력에는 type: json_object를 사용하거나, 스키마를 지원할 때 type: json_schema와 json_schema를 함께 지정하세요. |
POST /v1/responses
| 필드 | 유형 | 필수 여부 | 설명 |
|---|---|---|---|
model | string | 필수 | 모델 ID를 qwen3.8-flash로 설정하세요. |
input | string / object[] | 필수 | 입력 텍스트 또는 순서가 있는 입력 항목 배열입니다. 메시지 항목에는 role과 content를 사용합니다. |
instructions | string | 선택 | 작업과 출력 요구 사항을 지정하는 모델 지침입니다. |
max_output_tokens | integer | 선택 | 출력 토큰 수의 상한입니다. 허용 범위는 모델과 엔드포인트에 따라 다릅니다. |
stream | boolean | 선택 | true는 SSE 스트리밍, false는 일반 JSON 응답을 요청합니다. 지원 모드는 엔드포인트에 따라 다릅니다. |
store | boolean | 조건부 | 이 필드를 지원하는 경우 false는 나중에 조회하기 위한 응답 저장을 하지 않도록 요청합니다. |
text.format | object | 조건부 | 구조화된 출력은 text.format에 지정합니다. 예를 들어 type: json_schema를 사용할 수 있습니다. 해당 형식을 지원하는 엔드포인트에서만 사용하세요. |
temperature | number | 조건부 | 샘플링의 무작위성을 조절합니다. 허용값과 적용 여부는 모델 및 엔드포인트에 따라 다릅니다. |
top_p | number | 조건부 | 누적 확률로 샘플링 후보를 제한합니다. 모델과 엔드포인트에서 지원할 때 사용하세요. |
요청 예시
API Key를 로컬 환경 변수 ICODEEASY_API_KEY에 설정하고 직접 HTTP 호출을 허용하는 엔드포인트를 선택하세요. 특정 클라이언트가 필요한 경우 해당 설정 가이드를 따르세요.
Anthropic Messages
bash
curl -sS 'https://api.icodeeasy.cc/v1/messages' \
-H "x-api-key: $ICODEEASY_API_KEY" \
-H 'Content-Type: application/json' \
-H 'anthropic-version: 2023-06-01' \
--data '{
"model": "qwen3.8-flash",
"max_tokens": 256,
"messages": [
{
"role": "user",
"content": "Explain how a rainbow forms in one sentence."
}
]
}'
Chat Completions
bash
curl -sS 'https://api.icodeeasy.cc/v1/chat/completions' \
-H "Authorization: Bearer $ICODEEASY_API_KEY" \
-H 'Content-Type: application/json' \
--data '{
"model": "qwen3.8-flash",
"messages": [
{
"role": "user",
"content": "Explain how a rainbow forms in one sentence."
}
],
"stream": false
}'
OpenAI Responses
bash
curl -N -sS 'https://api.icodeeasy.cc/v1/responses' \
-H "Authorization: Bearer $ICODEEASY_API_KEY" \
-H 'Content-Type: application/json' \
--data '{
"model": "qwen3.8-flash",
"instructions": "You are a helpful assistant.",
"input": [
{
"type": "message",
"role": "user",
"content": [
{
"type": "input_text",
"text": "Explain how a rainbow forms in one sentence."
}
]
}
],
"stream": true,
"store": false
}'
응답 읽기
- Anthropic Messages ·
content[]에서 유형이text인 블록을 읽으세요. 스트리밍 시 SSE 콘텐츠 블록 이벤트를 순서대로 처리하세요. JSON · SSE - Chat Completions ·
choices[].message.content에서 텍스트를 읽으세요. SSE 스트림에서는choices[].delta로 새 출력이 전송됩니다. JSON · SSE - OpenAI Responses · 스트리밍 시
response.output_text.delta이벤트의delta를 연결하고 완료 및 실패 이벤트를 처리하세요. SSE
관련 가이드
Qwen API 및 Claude Code 설정 가이드
I Code Easy API Key로 Claude Code에서 Qwen3.8-Max 또는 Flash를 설정합니다. macOS, Linux, Windows 환경 변수와 모델 전환, 연결 확인, 오류 해결 방법을 안내합니다.
Anthropic Messages
Anthropic Messages 형식으로 HTTP 요청을 보냅니다. Claude Code 설정은 관련 가이드를 참고하세요.
Chat Completions
OpenAI Chat 형식으로 대화를 보냅니다. 요청 전에 모델과 선택한 엔드포인트가 Chat을 지원하는지 확인하세요.