사용자 지정 모델 생성

curl --request POST \
  --url https://api.apimart.ai/v1/music/generations/createModel \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "suno",
    "name": "warm folk model",
    "audio_urls": [
      "https://example.com/ref-01.mp3",
      "https://example.com/ref-02.mp3",
      "https://example.com/ref-03.wav",
      "https://example.com/ref-04.m4a",
      "https://example.com/ref-05.mp3",
      "https://example.com/ref-06.mp3"
    ]
  }'

import requests

response = requests.post(
    "https://api.apimart.ai/v1/music/generations/createModel",
    headers={"Authorization": "Bearer <token>"},
    json={
        "model": "suno",
        "name": "warm folk model",
        "audio_urls": [
            "https://example.com/ref-01.mp3",
            "https://example.com/ref-02.mp3",
            "https://example.com/ref-03.wav",
            "https://example.com/ref-04.m4a",
            "https://example.com/ref-05.mp3",
            "https://example.com/ref-06.mp3",
        ],
    },
)
print(response.json())

const response = await fetch("https://api.apimart.ai/v1/music/generations/createModel", {
  method: "POST",
  headers: {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "suno",
    name: "warm folk model",
    audio_urls: [
      "https://example.com/ref-01.mp3",
      "https://example.com/ref-02.mp3",
      "https://example.com/ref-03.wav",
      "https://example.com/ref-04.m4a",
      "https://example.com/ref-05.mp3",
      "https://example.com/ref-06.mp3"
    ]
  })
});
console.log(await response.json());

{
  "code": 200,
  "data": [
    {"status": "submitted", "task_id": "task_01M24YMN4EV04M84R5QYM77R1E"}
  ]
}

{
  "code": 200,
  "data": {
    "id": "task_01M24YMN4EV04M84R5QYM77R1E",
    "status": "completed",
    "progress": 100,
    "result": {
      "model_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "warm folk music model"
    }
  }
}

POST

music

generations

createModel

curl --request POST \
  --url https://api.apimart.ai/v1/music/generations/createModel \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "suno",
    "name": "warm folk model",
    "audio_urls": [
      "https://example.com/ref-01.mp3",
      "https://example.com/ref-02.mp3",
      "https://example.com/ref-03.wav",
      "https://example.com/ref-04.m4a",
      "https://example.com/ref-05.mp3",
      "https://example.com/ref-06.mp3"
    ]
  }'

import requests

response = requests.post(
    "https://api.apimart.ai/v1/music/generations/createModel",
    headers={"Authorization": "Bearer <token>"},
    json={
        "model": "suno",
        "name": "warm folk model",
        "audio_urls": [
            "https://example.com/ref-01.mp3",
            "https://example.com/ref-02.mp3",
            "https://example.com/ref-03.wav",
            "https://example.com/ref-04.m4a",
            "https://example.com/ref-05.mp3",
            "https://example.com/ref-06.mp3",
        ],
    },
)
print(response.json())

const response = await fetch("https://api.apimart.ai/v1/music/generations/createModel", {
  method: "POST",
  headers: {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "suno",
    name: "warm folk model",
    audio_urls: [
      "https://example.com/ref-01.mp3",
      "https://example.com/ref-02.mp3",
      "https://example.com/ref-03.wav",
      "https://example.com/ref-04.m4a",
      "https://example.com/ref-05.mp3",
      "https://example.com/ref-06.mp3"
    ]
  })
});
console.log(await response.json());

{
  "code": 200,
  "data": [
    {"status": "submitted", "task_id": "task_01M24YMN4EV04M84R5QYM77R1E"}
  ]
}

{
  "code": 200,
  "data": {
    "id": "task_01M24YMN4EV04M84R5QYM77R1E",
    "status": "completed",
    "progress": 100,
    "result": {
      "model_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "warm folk music model"
    }
  }
}

모델 생성은 비동기입니다. 제출 후 task_id로 작업을 폴링하고 완료되면 data.result.model_id에서 커스텀 모델 ID를 읽으세요.

curl --request POST \
  --url https://api.apimart.ai/v1/music/generations/createModel \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "suno",
    "name": "warm folk model",
    "audio_urls": [
      "https://example.com/ref-01.mp3",
      "https://example.com/ref-02.mp3",
      "https://example.com/ref-03.wav",
      "https://example.com/ref-04.m4a",
      "https://example.com/ref-05.mp3",
      "https://example.com/ref-06.mp3"
    ]
  }'

import requests

response = requests.post(
    "https://api.apimart.ai/v1/music/generations/createModel",
    headers={"Authorization": "Bearer <token>"},
    json={
        "model": "suno",
        "name": "warm folk model",
        "audio_urls": [
            "https://example.com/ref-01.mp3",
            "https://example.com/ref-02.mp3",
            "https://example.com/ref-03.wav",
            "https://example.com/ref-04.m4a",
            "https://example.com/ref-05.mp3",
            "https://example.com/ref-06.mp3",
        ],
    },
)
print(response.json())

const response = await fetch("https://api.apimart.ai/v1/music/generations/createModel", {
  method: "POST",
  headers: {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "suno",
    name: "warm folk model",
    audio_urls: [
      "https://example.com/ref-01.mp3",
      "https://example.com/ref-02.mp3",
      "https://example.com/ref-03.wav",
      "https://example.com/ref-04.m4a",
      "https://example.com/ref-05.mp3",
      "https://example.com/ref-06.mp3"
    ]
  })
});
console.log(await response.json());

Authorizations

string

필수

Bearer Token. API Key 관리 페이지에서 API Key를 받으세요.

Body

string

기본값:"suno"

항상 suno를 사용합니다.

string

필수

커스텀 모델 이름. 앞뒤 공백을 제거한 뒤 비어 있으면 안 됩니다.

string[]

필수

공개적으로 접근 가능한 직접 HTTP(S) 오디오 URL 6~24개입니다. MP3, WAV, M4A를 권장합니다. 각 URL은 로그인 페이지가 아니라 오디오 파일을 직접 반환해야 합니다.

잘못된 미디어 파일 하나로 전체 모델 생성 작업이 실패할 수 있습니다. 로컬 파일을 먼저 업로드해 공개 URL을 사용하고 로컬 경로나 blob: URL은 보내지 마세요.

Response

integer

응답 상태 코드.

array

제출 결과. data[0].task_id를 읽고 GET /v1/music/tasks/{task_id}로 학습 상태를 조회하세요.

{
  "code": 200,
  "data": [
    {"status": "submitted", "task_id": "task_01M24YMN4EV04M84R5QYM77R1E"}
  ]
}

{
  "code": 200,
  "data": {
    "id": "task_01M24YMN4EV04M84R5QYM77R1E",
    "status": "completed",
    "progress": 100,
    "result": {
      "model_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "warm folk music model"
    }
  }
}

생성한 모델 사용

완료 후 result.model_id를 저장합니다. 이후 커스텀 모델 요청에서 이를 custom_model_id로 사용하고 version과 persona_id는 생략하세요.

{
  "model": "suno",
  "custom_model_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "custom": true,
  "instrumental": false,
  "prompt": "[Verse]\nan old wooden guitar plays a new journey",
  "style": "acoustic folk, warm vocals",
  "max_mode": true,
  "audio_format": "mp3"
}

모델 생성은 몇 분, 경우에 따라 약 20분이 걸릴 수 있습니다. 커스텀 모델 사용 가능 기간은 달라질 수 있으므로 고정 만료 시간을 약속하지 마세요. 모델 생성과 각 생성 요청은 별도로 과금됩니다.

개요

모델

텍스트 시리즈

이미지 시리즈

비디오 시리즈

오디오 시리즈

모더레이션 시리즈

업로드 관리

작업 관리

계정 관리

사용자 지정 모델 생성

Authorizations

Body

Response

생성한 모델 사용

​Authorizations

​Body

​Response

​생성한 모델 사용

Authorizations

Body

Response

생성한 모델 사용