snow · 2026.4.24 13:21 · 조회 2
MiniMax API 연동 가이드
기본 설정
MiniMax API는 OpenAI 호환 인터페이스를 제공하므로, 기존 OpenAI SDK를 그대로 사용할 수 있습니다.
Base URL: https://api.minimaxi.chat/v1
Auth: Bearer {API_KEY}
텍스트 생성 API
Chat Completions
1import requests2 3url = "https://api.minimaxi.chat/v1/chat/completions"4headers = {5 "Authorization": f"Bearer {API_KEY}",6 "Content-Type": "application/json"7}8payload = {9 "model": "MiniMax-Text-01",10 "messages": [11 {"role": "system", "content": "You are a helpful assistant."},12 {"role": "user", "content": "한국어로 설명해줘"}13 ],14 "max_tokens": 1000,15 "temperature": 0.7,16 "stream": False17}18response = requests.post(url, json=payload, headers=headers)스트리밍
1payload["stream"] = True2response = requests.post(url, json=payload, headers=headers, stream=True)3for line in response.iter_lines():4 if line.startswith(b"data: "):5 print(line[6:].decode())영상 생성 API
1import requests, time2 3# 1. 영상 생성 요청4res = requests.post(5 "https://api.minimaxi.chat/v1/video_generation",6 headers={"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"},7 json={"model": "video-01", "prompt": "A sunset over the ocean"}8)9task_id = res.json()["task_id"]10 11# 2. 완료 대기 (폴링)12while True:13 status = requests.get(14 f"https://api.minimaxi.chat/v1/query/video_generation?task_id={task_id}",15 headers={"Authorization": f"Bearer {API_KEY}"}16 ).json()17 if status["status"] == "Success":18 print("영상 URL:", status["file_id"])19 break20 time.sleep(5)음성 합성 API
1import requests, base642 3res = requests.post(4 "https://api.minimaxi.chat/v1/t2a_v2",5 headers={"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"},6 json={7 "model": "speech-02-hd",8 "text": "안녕하세요!",9 "voice_setting": {"voice_id": "Korean_Female_1", "speed": 1.0},10 "audio_setting": {"format": "mp3"}11 }12)13audio_data = base64.b64decode(res.json()["data"]["audio"])14with open("output.mp3", "wb") as f:15 f.write(audio_data)에러 처리
| 코드 | 원인 | 해결 |
|---|---|---|
| 401 | 잘못된 API Key | Key 재확인 |
| 429 | 속도 제한 초과 | 재시도 로직 추가 |
| 402 | 크레딧 부족 | 충전 후 재시도 |
| 500 | 서버 오류 | 잠시 후 재시도 |
댓글
아직 댓글이 없습니다.
댓글을 작성하려면 로그인이 필요합니다.