Token Plan (Team Edition)
모든 직접 호출 상황에 대한 범용 권한으로 사용하지 마세요. 테스트 및 애플리케이션 연동에는 일반 API 경로를 사용하세요.
도구 + 모델 연계
Alibaba Model Studio API과(와) 함께 사용하는 Postman / cURL
모델 스튜디오 요청, 헤더, 페이로드 및 엔드포인트 동작을 검증하기 위한 API 테스트 경로입니다.
Postman과 cURL은 요청 구조, 헤더, 모델 동작을 검증하는 데 유용하지만, 이는 대화형 코딩 에이전트가 아닌 직접적인 API 호출 인터페이스입니다.
올바른 액세스 경로 선택
올바른 액세스 경로 선택
일반 pay-as-you-go Model Studio API 키와 일치하는 지역 엔드포인트를 사용하세요. Alibaba는 Postman에서 Coding Plan를 직접 호출하는 것을 명시적으로 권장하지 않습니다.
추천Pay-as-you-go Model Studio API
Coding Plan
Alibaba는 Postman 호출을 명시적으로 권장하지 않으며, 비대화형(non-interactive) API 시나리오를 금지합니다.
Pay-as-you-go Model Studio API
수동 API 검증, 스크립트, 통합 테스트, 백엔드 개발에 적합한 올바른 경로입니다.
안전한 구성 패턴
일반 OpenAI 호환 Model Studio 엔드포인트 테스트
예시는 의도적으로 마스킹되어 있습니다. 플레이스홀더는 사용자의 기기에서만 교체하고, 실제 API 키를 Nfero에 붙여넣지 마세요.
시작하기 전에
- 배포 지역에서 일반 Model Studio API 키를 생성합니다.
- 동일한 지역 및 API 프로토콜을 지원하는 모델을 선택합니다.
- 키를 Postman의 시크릿/현재 값 또는 환경 변수에 저장합니다.
- 요청을 반복하거나 자동화하기 전에 과금 알림을 설정합니다.
안전한 구성 패턴
- 프로토콜
- OpenAI-compatible Model Studio API
- Alibaba의 기본 URL 문서에 명시된 지역별 일반 엔드포인트를 사용하세요.
- API 키를 Authorization 헤더에 포함하여 전송하되, 코드 내에 출력하거나 커밋하지 마세요.
- 간단한 프롬프트와 낮은 출력 제한(output limit)으로 시작하세요.
- 요청이 검증된 후, 프로덕션 코드를 서버 측 비밀 저장소(server-side secret storage)로 이전하세요.
연결 확인
- 키의 지역(Region)이 엔드포인트와 일치하는지 확인하세요.
- 응답 상태, 요청 ID, 모델 ID, 사용량 필드를 검사하세요.
- 내보낸 Postman 컬렉션이 현재 비밀 값(secret values)을 포함하지 않는지 확인하세요.
- 엔드포인트가 특정 요금제(plan)에 종속되지 않은 일반적인 Model Studio 엔드포인트인지 확인하세요.
모델 연계
추천 시작 모델
이 도구을 사용하여 각 모델과 함께 대화형 코딩, 추론, 검토 및 문서 작업을 수행하세요. 생산 환경에서 최종 모델 가용성과 정확한 계획 지원은 Alibaba Cloud에서 확인하십시오.
Qwenqwen3.7-plus
텍스트 생성추론시각적 이해
최적의 조합 각도
현재 범용 모델 라우트입니다. 키가 있는 지역에서 사용 가능 여부를 확인하세요.
Qwenqwen3.6-flash
텍스트 생성추론시각적 이해
최적의 조합 각도
요청 형식 테스트 및 기본 통합 점검에 효율적인 옵션입니다.
자주 발생하는 문제
자주 발생하는 문제
증상
401 오류: 잘못된 API 키
가능한 원인
API 키가 누락되었거나, 잘렸거나, 다른 요금제 또는 다른 지역(region)에서 발급된 키입니다.
해결 방법
엔드포인트와 동일한 Model Studio 지역 및 워크스페이스에서 제공된 일반 키를 사용하세요.
증상
예기치 않은 요금제 일시 중단 또는 차단된 키
가능한 원인
Coding Plan 또는 Token Plan 키가 직접 호출 또는 자동화된 API 요청에 사용되었습니다.
해결 방법
일반 pay-as-you-go Model Studio API 키로 교체하세요.
주요 제한 사항
- 실제 키를 절대 Nfero, 공개 컬렉션, 공유를 목적으로 한 명령 기록, 또는 소스 코드 관리 시스템에 붙여넣지 마세요.
- 직접 스크립트, 일괄 테스트 또는 백엔드 호출에 Coding Plan 또는 Token Plan 자격 증명을 사용하지 마세요.
- 요청 동작을 검증할 때는 낮은 제한과 과금 알림을 사용하세요.