1. API 키 생성
IteraCompute 계정을 생성하거나 로그인한 다음 콘솔에서 키를 생성하세요.
IteraCompute 계정을 생성하거나 로그인한 다음 콘솔에서 키를 생성하세요.
IteraCompute baseURL을 사용하여 OpenAI 호환 제공자를 생성하고 해당 모델을 generateText에 전달합니다.
선택한 모델에 대한 정확한 API 모델 ID를 사용하세요.에이전트 또는 비전 기능을 활성화하기 전에 해당 컨텍스트와 기능을 확인하세요.
서버 환경이나 도구 자격 증명 저장소에 API 키를 보관하세요.해당하는 경우 예제 키 필드를 사용자 고유의 키로 바꿉니다.
import { createOpenAICompatible } from "@ai-sdk/openai-compatible";
import { generateText } from "ai";
if (!process.env.ITERACOMPUTE_API_KEY) {
throw new Error("Set ITERACOMPUTE_API_KEY on the server.");
}
const itera = createOpenAICompatible({
name: "iteracompute",
baseURL: "https://api.iteracompute.com/v1",
apiKey: process.env.ITERACOMPUTE_API_KEY,
});
const { text } = await generateText({
model: itera("qwen/qwen3.8-27b"),
prompt: "Reply with exactly: Hello!",
maxOutputTokens: 512,
providerOptions: { iteracompute: { chat_template_kwargs: { enable_thinking: false } } },
});
if (!text.trim()) throw new Error("Empty model reply: activation is incomplete.");
console.log(text);# Bash / zsh / WSL; set ITERACOMPUTE_API_KEY in your environment first.
curl --fail-with-body https://api.iteracompute.com/v1/chat/completions \
-H "Authorization: Bearer $ITERACOMPUTE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"qwen/qwen3.8-27b","messages":[{"role":"user","content":"Reply with exactly: Hello!"}],"max_tokens":512}'choice[0].message.content에 보이는 텍스트가 포함되어 있는지 확인하세요.HTTP 200만으로는 부족합니다.추론은 출력 예산을 소비할 수 있습니다.무료 Qwen을 사용하려면 다음을 사용하세요. 첫 번째 무료 통화 예시 사고를 비활성화하려면 도구 내부에 메시지를 보내세요.
export ITERACOMPUTE_API_KEY="your-api-key"
curl --fail-with-body --max-time 180 https://api.iteracompute.com/v1/chat/completions \
-H "Authorization: Bearer $ITERACOMPUTE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"qwen/qwen3.8-27b","messages":[{"role":"user","content":"Reply with exactly: Hello!"}],"max_tokens":512,"chat_template_kwargs":{"enable_thinking":false}}' \
-o response.json && python3 -c 'import json; r=json.load(open("response.json")); text=r["choices"][0]["message"]["content"]; assert text and text.strip(), "Empty model reply: activation is incomplete"; print(text)'성공은 비어 있지 않은 선택[0].message.content를 의미합니다.이 명령은 이를 인쇄하고 빈 응답으로 실패합니다.등록 또는 HTTP 200만으로는 활성화가 완료되지 않습니다.예상 출력: 안녕하세요!(문구는 다를 수 있습니다).
이 Qwen 예는 짧은 눈에 보이는 답변에 대한 생각을 비활성화합니다.401/403: 키와 모델 권한을 확인하세요.429: 콘솔에서 월간 사용량과 TPM을 확인한 후 재시도 후를 따릅니다.여유 용량이 대기열에 있을 수 있습니다.반복적인 병렬 재시도를 실행하지 마십시오.
mkdir itera-ai-example
cd itera-ai-example
npm init -y
npm install ai@7.0.137 @ai-sdk/openai-compatible@3.0.67
export ITERACOMPUTE_API_KEY="your-api-key"
# Save the example above as example.mjs
node example.mjsNode.js 22 이상을 사용하세요.서버에서 example.mjs를 실행합니다.서버 환경 변수 또는 배포 비밀에 키를 보관하세요.NEXT_PUBLIC_ 또는 VITE_를 사용하거나, .env 파일을 커밋하거나, 브라우저 코드에서 API를 호출하지 마세요.이 샘플은 무료 Qwen과 함께 채팅 완료를 사용합니다.사고 옵션은 Qwen3.8-27B에만 적용됩니다.
Node.js 25.2.1, ai 7.0.137 및 @ai-sdk/openai- Compatible 3.0.67로 2026년 10월 11일에 확인되었습니다.실제 API 결과: 안녕하세요!(선행 공백 생략).샘플은 비어 있지 않은 응답을 확인합니다.이 예제는 서버 측 CLI 애플리케이션으로 실행됩니다.
Hello!선택한 모델의 API 기능입니다.워크플로의 기능 가용성은 도구 및 해당 설정에 따라 달라집니다.추론 제어는 모델에 따라 다릅니다.
qwen/qwen3.8-27b에 대한 API 키와 권한을 확인하세요.프리 티어에는 잔액이나 카드가 필요하지 않습니다.다른 모델에는 유료 잔액이 필요할 수 있습니다.
OpenAI Compatible, /v1 기본 URL 및 qwen/qwen3.8-27b를 정확하게 사용하세요.채팅 완료 기능을 사용하세요.응답이 지원된다고 가정하지 마십시오.Qwen3.8-2.4T-A95B는 다른 유료 모델입니다.
무료의 경우 입력과 요청된 최대 출력이 131072 토큰에 맞아야 합니다.첨부파일/기록 또는 출력 예산을 줄입니다.내용이 비어 있는 HTTP 200은 불완전합니다.생각을 방해하는 짧은 무료 통화 예시를 시도해 보세요.
콘솔에서 계정 전체의 월간 사용량과 TPM을 확인하세요.이후 재시도를 존중하고 병렬 재시도를 방지합니다.소진된 할당량에는 초과분 자동 지불이 없습니다.UTC 월별 재설정을 기다리거나 충전을 통해 더 높은 등급을 잠금 해제하세요.
401 / 403 : 키와 모델 권한을 확인하세요.무료 Qwen에는 잔액이나 카드가 필요하지 않습니다.유료 모델의 경우 사용 가능한 잔액도 확인하세요.