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 KeyKey 재확인
429속도 제한 초과재시도 로직 추가
402크레딧 부족충전 후 재시도
500서버 오류잠시 후 재시도

댓글

아직 댓글이 없습니다.

댓글을 작성하려면 로그인이 필요합니다.