Перейти к основному содержанию
POST
/
v1
/
music
/
generations
/
replaceFlowMusic
curl --request POST \
  --url https://api.apimart.ai/v1/music/generations/replaceFlowMusic \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "flowmusic",
    "clip_id": "abc123-def456",
    "start_s": 10,
    "end_s": 20,
    "instruction": "Заменить фортепианной версией"
  }'
import requests

url = "https://api.apimart.ai/v1/music/generations/replaceFlowMusic"

payload = {
    "model": "flowmusic",
    "clip_id": "abc123-def456",
    "start_s": 10,
    "end_s": 20,
    "instruction": "Заменить фортепианной версией"
}

headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())
const url = "https://api.apimart.ai/v1/music/generations/replaceFlowMusic";

const payload = {
  model: "flowmusic",
  clip_id: "abc123-def456",
  start_s: 10,
  end_s: 20,
  instruction: "Заменить фортепианной версией"
};

const headers = {
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
};

fetch(url, {
  method: "POST",
  headers: headers,
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KWXVHGTG5JM33S8FG1K90YQ6"
    }
  ]
}
{
  "error": {
    "message": "end_s must be greater than start_s",
    "type": "invalid_request",
    "param": "",
    "code": "invalid_request"
  }
}
{
  "error": {
    "message": "Недостаточно средств на балансе",
    "type": "invalid_request",
    "param": "",
    "code": "quota_not_enough"
  }
}
{
  "error": {
    "message": "Текущая группа перегружена, повторите попытку позже",
    "type": "rate_limit_error",
    "param": "",
    "code": "rate_limit_error"
  }
}
curl --request POST \
  --url https://api.apimart.ai/v1/music/generations/replaceFlowMusic \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "flowmusic",
    "clip_id": "abc123-def456",
    "start_s": 10,
    "end_s": 20,
    "instruction": "Заменить фортепианной версией"
  }'
import requests

url = "https://api.apimart.ai/v1/music/generations/replaceFlowMusic"

payload = {
    "model": "flowmusic",
    "clip_id": "abc123-def456",
    "start_s": 10,
    "end_s": 20,
    "instruction": "Заменить фортепианной версией"
}

headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())
const url = "https://api.apimart.ai/v1/music/generations/replaceFlowMusic";

const payload = {
  model: "flowmusic",
  clip_id: "abc123-def456",
  start_s: 10,
  end_s: 20,
  instruction: "Заменить фортепианной версией"
};

const headers = {
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
};

fetch(url, {
  method: "POST",
  headers: headers,
  body: JSON.stringify(payload)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KWXVHGTG5JM33S8FG1K90YQ6"
    }
  ]
}
{
  "error": {
    "message": "end_s must be greater than start_s",
    "type": "invalid_request",
    "param": "",
    "code": "invalid_request"
  }
}
{
  "error": {
    "message": "Недостаточно средств на балансе",
    "type": "invalid_request",
    "param": "",
    "code": "quota_not_enough"
  }
}
{
  "error": {
    "message": "Текущая группа перегружена, повторите попытку позже",
    "type": "rate_limit_error",
    "param": "",
    "code": "rate_limit_error"
  }
}

Аутентификация

Authorization
string
обязательно
Все эндпоинты требуют аутентификации с помощью Bearer TokenПолучение API Key:Посетите страницу управления API Key, чтобы получить ваш API KeyДобавьте его в заголовок запроса:
Authorization: Bearer YOUR_API_KEY

Параметры запроса

model
string
обязательно
Название модели, всегда передавайте "flowmusic" (без учёта регистра)
clip_id
string
обязательно
clip_id исходной композиции, из result.music[].clip_id успешно завершённой задачи
start_s
number
обязательно
Время начала замены (в секундах)
end_s
number
обязательно
Время окончания замены (в секундах)
end_s должно быть больше start_s и не может превышать длительность исходного клипа.
instruction
string
обязательно
Инструкция редактирования для заменяемого фрагментаПример: "Заменить фортепианной версией"
title
string
Название композиции после замены
seed
integer
Случайное зерно (seed) для воспроизведения или управления результатом генерации

Ответ

code
integer
Код статуса ответа, 200 при успехе
data
array
Массив возвращаемых данных

Сценарии использования

Сценарий 1: заменить фрагмент 10–20 секунд фортепианной версией

{
  "model": "flowmusic",
  "clip_id": "abc123-def456",
  "start_s": 10,
  "end_s": 20,
  "instruction": "Заменить фортепианной версией"
}
Запрос результата задачиЗамена фрагмента — асинхронная задача; после отправки возвращается task_id. Используйте эндпоинт Получение статуса задачи для запроса прогресса и результата генерации. Результат замены — новый clip_id (вся композиция выводится заново, при этом указанный интервал заменён); для последующих операций используйте новый clip_id.

Пример результата выполненной задачи

Пример ответа на запрос (GET /v1/music/tasks/{task_id}):
{
  "code": 200,
  "data": {
    "id": "task_01KWXVHGTG5JM33S8FG1K90YQ6",
    "status": "completed",
    "progress": 100,
    "created": 1783413392,
    "completed": 1783413454,
    "actual_time": 62,
    "cost": 0.048,
    "credits_cost": 0.48,
    "result": {
      "music": [
        {
          "clip_id": "9508d1fe-633e-464b-8a40-c6368e5464fa",
          "title": "Untitled (Replaced)",
          "duration_seconds": "181.58933333",
          "create_time": "2026-07-07T08:37:13.864452Z",
          "lyrics": "[Verse 1]\nWaking up to the morning light,\n...",
          "lyrics_id": "c302d603-81b6-552f-8122-e512928d6aa1",
          "lyrics_timing_markers": [[10, 12], [71, 15]],
          "audio_url": "https://cdn.apimart.ai/audio/flowmusic_9508d1fe.m4a",
          "wav_url": "https://cdn.apimart.ai/audio/flowmusic_9508d1fe.wav",
          "image_url": "https://cdn.apimart.ai/image/flowmusic_9508d1fe_cover.jpg"
        }
      ]
    }
  }
}