Flow Music 음악 생성

curl --request POST \
  --url https://aireiter.com/api/openapi/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
"model": "flow_music",
"params": {
  "prompt": "짧은 어쿠스틱 기타 루프, 보컬 없음",
  "length": 60,
  "version": "lyria-3-pro"
},
"out_task_id": "flow_music_gen_123456"
}'

import requests

url = "https://aireiter.com/api/openapi/submit"

payload = {
    "model": "flow_music",
    "params": {
      "prompt": "짧은 어쿠스틱 기타 루프, 보컬 없음",
      "length": 60,
      "version": "lyria-3-pro"
},
    "out_task_id": "flow_music_gen_123456"
}

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

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

print(response.json())

const url = "https://aireiter.com/api/openapi/submit";

const payload = {
  model: "flow_music",
  params: {
    "prompt": "짧은 어쿠스틱 기타 루프, 보컬 없음",
    "length": 60,
    "version": "lyria-3-pro"
},
  out_task_id: "flow_music_gen_123456"
};

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));

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io/ioutil"
    "net/http"
)

func main() {
    url := "https://aireiter.com/api/openapi/submit"

    payload := map[string]interface{}{
        "model": "flow_music",
        "params": map[string]interface{}{
            "prompt": "짧은 어쿠스틱 기타 루프, 보컬 없음",
            "length": 60,
            "version": "lyria-3-pro",
        },
        "out_task_id": "flow_music_gen_123456",
    }

    jsonData, _ := json.Marshal(payload)

    req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
    req.Header.Set("Authorization", "Bearer <token>")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := ioutil.ReadAll(resp.Body)
    fmt.Println(string(body))
}

import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
    public static void main(String[] args) throws Exception {
        String url = "https://aireiter.com/api/openapi/submit";

        String payload = """
{
"model": "flow_music",
"params": {
  "prompt": "짧은 어쿠스틱 기타 루프, 보컬 없음",
  "length": 60,
  "version": "lyria-3-pro"
},
"out_task_id": "flow_music_gen_123456"
}
        """;

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(url))
            .header("Authorization", "Bearer <token>")
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(payload))
            .build();

        HttpResponse<String> response = client.send(request,
            HttpResponse.BodyHandlers.ofString());

        System.out.println(response.body());
    }
}

<?php

$url = "https://aireiter.com/api/openapi/submit";

$payload = [
    "model" => "flow_music",
    "params" => [
        "prompt" => "짧은 어쿠스틱 기타 루프, 보컬 없음",
        "length" => 60,
        "version" => "lyria-3-pro",
    ],
    "out_task_id" => "flow_music_gen_123456"
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

require 'net/http'
require 'json'
require 'uri'

url = URI("https://aireiter.com/api/openapi/submit")

payload = {
  model: "flow_music",
  params: {
    prompt: "짧은 어쿠스틱 기타 루프, 보컬 없음",
    length: 60,
    version: "lyria-3-pro",
  },
  out_task_id: "flow_music_gen_123456"
}

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Post.new(url)
request["Authorization"] = "Bearer <token>"
request["Content-Type"] = "application/json"
request.body = payload.to_json

response = http.request(request)
puts response.body

import Foundation

let url = URL(string: "https://aireiter.com/api/openapi/submit")!

let payload: [String: Any] = [
    "model": "flow_music",
    "params": [
        "prompt": "짧은 어쿠스틱 기타 루프, 보컬 없음",
        "length": 60,
        "version": "lyria-3-pro",
    ],
    "out_task_id": "flow_music_gen_123456"
]

var request = URLRequest(url: url)
request.httpMethod = "POST"
request.setValue("Bearer <token>", forHTTPHeaderField: "Authorization")
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
request.httpBody = try? JSONSerialization.data(withJSONObject: payload)

let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let error = error {
        print("오류: \(error)")
        return
    }

    if let data = data, let responseString = String(data: data, encoding: .utf8) {
        print(responseString)
    }
}

task.resume()

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        var url = "https://aireiter.com/api/openapi/submit";

        var payload = @"
{
""model"": ""flow_music"",
""params"": {
  ""prompt"": ""짧은 어쿠스틱 기타 루프, 보컬 없음"",
  ""length"": 60,
  ""version"": ""lyria-3-pro""
},
""out_task_id"": ""flow_music_gen_123456""
}";

        using var client = new HttpClient();
        client.DefaultRequestHeaders.Add("Authorization", "Bearer <token>");

        var content = new StringContent(payload, Encoding.UTF8, "application/json");
        var response = await client.PostAsync(url, content);
        var result = await response.Content.ReadAsStringAsync();

        Console.WriteLine(result);
    }
}

#include <stdio.h>
#include <curl/curl.h>

int main(void) {
    CURL *curl;
    CURLcode res;

    curl_global_init(CURL_GLOBAL_DEFAULT);
    curl = curl_easy_init();

    if(curl) {
        const char *url = "https://aireiter.com/api/openapi/submit";
        const char *payload = "{\"model\": \"flow_music\", \"params\": {\"prompt\": \"짧은 어쿠스틱 기타 루프, 보컬 없음\", \"length\": 60, \"version\": \"lyria-3-pro\"}, \"out_task_id\": \"flow_music_gen_123456\"}";

        struct curl_slist *headers = NULL;
        headers = curl_slist_append(headers, "Authorization: Bearer <token>");
        headers = curl_slist_append(headers, "Content-Type: application/json");

        curl_easy_setopt(curl, CURLOPT_URL, url);
        curl_easy_setopt(curl, CURLOPT_POSTFIELDS, payload);
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);

        res = curl_easy_perform(curl);

        if(res != CURLE_OK) {
            fprintf(stderr, "curl_easy_perform() 실패: %s\n",
                    curl_easy_strerror(res));
        }

        curl_slist_free_all(headers);
        curl_easy_cleanup(curl);
    }

    curl_global_cleanup();
    return 0;
}

#import <Foundation/Foundation.h>

int main(int argc, const char * argv[]) {
    @autoreleasepool {
        NSURL *url = [NSURL URLWithString:@"https://aireiter.com/api/openapi/submit"];

        NSDictionary *payload = @{
            @"model": @"flow_music",
            @"params": @{
                @"prompt": @"짧은 어쿠스틱 기타 루프, 보컬 없음",
                @"length": @60,
                @"version": @"lyria-3-pro",
            },
            @"out_task_id": @"flow_music_gen_123456"
        };

        NSError *error;
        NSData *jsonData = [NSJSONSerialization dataWithJSONObject:payload
                                                          options:0
                                                            error:&error];

        NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
        [request setHTTPMethod:@"POST"];
        [request setValue:@"Bearer <token>" forHTTPHeaderField:@"Authorization"];
        [request setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];
        [request setHTTPBody:jsonData];

        NSURLSessionDataTask *task = [[NSURLSession sharedSession]
            dataTaskWithRequest:request
            completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
                if (error) {
                    NSLog(@"오류: %@", error);
                    return;
                }
                NSString *result = [[NSString alloc] initWithData:data
                                                        encoding:NSUTF8StringEncoding];
                NSLog(@"%@", result);
            }];

        [task resume];
        [[NSRunLoop mainRunLoop] run];
    }
    return 0;
}

(* cohttp 및 yojson 라이브러리가 필요합니다 *)
open Lwt
open Cohttp
open Cohttp_lwt_unix

let url = "https://aireiter.com/api/openapi/submit"

let payload = {|{
"model": "flow_music",
"params": {
  "prompt": "짧은 어쿠스틱 기타 루프, 보컬 없음",
  "length": 60,
  "version": "lyria-3-pro"
},
"out_task_id": "flow_music_gen_123456"
}|}

let () =
  let headers = Header.init ()
    |> fun h -> Header.add h "Authorization" "Bearer <token>"
    |> fun h -> Header.add h "Content-Type" "application/json"
  in
  let body = Cohttp_lwt.Body.of_string payload in

  let response = Client.post ~headers ~body (Uri.of_string url) >>= fun (resp, body) ->
    body |> Cohttp_lwt.Body.to_string >|= fun body_str ->
    print_endline body_str
  in
  Lwt_main.run response

import 'dart:convert';
import 'package:http/http.dart' as http;

void main() async {
  final url = Uri.parse('https://aireiter.com/api/openapi/submit');

  final payload = {
    model: "flow_music",
    params: {
      prompt: "짧은 어쿠스틱 기타 루프, 보컬 없음",
      length: 60,
      version: "lyria-3-pro",
    },
    out_task_id: "flow_music_gen_123456"
  };

  final response = await http.post(
    url,
    headers: {
      'Authorization': 'Bearer <token>',
      'Content-Type': 'application/json'
    },
    body: jsonEncode(payload),
  );

  print(response.body);
}

library(httr)
library(jsonlite)

url <- "https://aireiter.com/api/openapi/submit"

payload <- list(
  model = "flow_music",
  params = list(
    prompt = "짧은 어쿠스틱 기타 루프, 보컬 없음",
    length = 60,
    version = "lyria-3-pro",
  ),
  out_task_id = "flow_music_gen_123456"
)

response <- POST(
  url,
  add_headers(
    Authorization = "Bearer <token>",
    `Content-Type` = "application/json"
  ),
  body = toJSON(payload, auto_unbox = TRUE),
  encode = "raw"
)

cat(content(response, "text"))

{
  "statusCode": 200,
  "message": "",
  "data": {
      "out_task_id": "flow_music_gen_123456",
      "status": "pending",
      "created_at": "2026-08-28T07:44:48.000Z"
  }
}

  {
      "statusCode": 400,
      "message": "요청 매개변수가 유효하지 않습니다",
      "ok": false
  }

{
  "error": {
    "code": 401,
    "message": "인증에 실패했습니다. API 키를 확인하세요"
  }
}

  {
    "error": {
      "code": 433,
      "message": "계정 잔액이 부족합니다. 충전 후 다시 시도하세요"
    }
  }

{
  "error": {
    "code": 500,
    "message": "서버 내부 오류입니다. 잠시 후 다시 시도하세요"
  }
}

POST

api

openapi

submit

curl --request POST \
  --url https://aireiter.com/api/openapi/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
"model": "flow_music",
"params": {
  "prompt": "짧은 어쿠스틱 기타 루프, 보컬 없음",
  "length": 60,
  "version": "lyria-3-pro"
},
"out_task_id": "flow_music_gen_123456"
}'

import requests

url = "https://aireiter.com/api/openapi/submit"

payload = {
    "model": "flow_music",
    "params": {
      "prompt": "짧은 어쿠스틱 기타 루프, 보컬 없음",
      "length": 60,
      "version": "lyria-3-pro"
},
    "out_task_id": "flow_music_gen_123456"
}

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

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

print(response.json())

const url = "https://aireiter.com/api/openapi/submit";

const payload = {
  model: "flow_music",
  params: {
    "prompt": "짧은 어쿠스틱 기타 루프, 보컬 없음",
    "length": 60,
    "version": "lyria-3-pro"
},
  out_task_id: "flow_music_gen_123456"
};

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));

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io/ioutil"
    "net/http"
)

func main() {
    url := "https://aireiter.com/api/openapi/submit"

    payload := map[string]interface{}{
        "model": "flow_music",
        "params": map[string]interface{}{
            "prompt": "짧은 어쿠스틱 기타 루프, 보컬 없음",
            "length": 60,
            "version": "lyria-3-pro",
        },
        "out_task_id": "flow_music_gen_123456",
    }

    jsonData, _ := json.Marshal(payload)

    req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
    req.Header.Set("Authorization", "Bearer <token>")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := ioutil.ReadAll(resp.Body)
    fmt.Println(string(body))
}

import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
    public static void main(String[] args) throws Exception {
        String url = "https://aireiter.com/api/openapi/submit";

        String payload = """
{
"model": "flow_music",
"params": {
  "prompt": "짧은 어쿠스틱 기타 루프, 보컬 없음",
  "length": 60,
  "version": "lyria-3-pro"
},
"out_task_id": "flow_music_gen_123456"
}
        """;

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(url))
            .header("Authorization", "Bearer <token>")
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(payload))
            .build();

        HttpResponse<String> response = client.send(request,
            HttpResponse.BodyHandlers.ofString());

        System.out.println(response.body());
    }
}

<?php

$url = "https://aireiter.com/api/openapi/submit";

$payload = [
    "model" => "flow_music",
    "params" => [
        "prompt" => "짧은 어쿠스틱 기타 루프, 보컬 없음",
        "length" => 60,
        "version" => "lyria-3-pro",
    ],
    "out_task_id" => "flow_music_gen_123456"
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

require 'net/http'
require 'json'
require 'uri'

url = URI("https://aireiter.com/api/openapi/submit")

payload = {
  model: "flow_music",
  params: {
    prompt: "짧은 어쿠스틱 기타 루프, 보컬 없음",
    length: 60,
    version: "lyria-3-pro",
  },
  out_task_id: "flow_music_gen_123456"
}

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Post.new(url)
request["Authorization"] = "Bearer <token>"
request["Content-Type"] = "application/json"
request.body = payload.to_json

response = http.request(request)
puts response.body

import Foundation

let url = URL(string: "https://aireiter.com/api/openapi/submit")!

let payload: [String: Any] = [
    "model": "flow_music",
    "params": [
        "prompt": "짧은 어쿠스틱 기타 루프, 보컬 없음",
        "length": 60,
        "version": "lyria-3-pro",
    ],
    "out_task_id": "flow_music_gen_123456"
]

var request = URLRequest(url: url)
request.httpMethod = "POST"
request.setValue("Bearer <token>", forHTTPHeaderField: "Authorization")
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
request.httpBody = try? JSONSerialization.data(withJSONObject: payload)

let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let error = error {
        print("오류: \(error)")
        return
    }

    if let data = data, let responseString = String(data: data, encoding: .utf8) {
        print(responseString)
    }
}

task.resume()

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        var url = "https://aireiter.com/api/openapi/submit";

        var payload = @"
{
""model"": ""flow_music"",
""params"": {
  ""prompt"": ""짧은 어쿠스틱 기타 루프, 보컬 없음"",
  ""length"": 60,
  ""version"": ""lyria-3-pro""
},
""out_task_id"": ""flow_music_gen_123456""
}";

        using var client = new HttpClient();
        client.DefaultRequestHeaders.Add("Authorization", "Bearer <token>");

        var content = new StringContent(payload, Encoding.UTF8, "application/json");
        var response = await client.PostAsync(url, content);
        var result = await response.Content.ReadAsStringAsync();

        Console.WriteLine(result);
    }
}

#include <stdio.h>
#include <curl/curl.h>

int main(void) {
    CURL *curl;
    CURLcode res;

    curl_global_init(CURL_GLOBAL_DEFAULT);
    curl = curl_easy_init();

    if(curl) {
        const char *url = "https://aireiter.com/api/openapi/submit";
        const char *payload = "{\"model\": \"flow_music\", \"params\": {\"prompt\": \"짧은 어쿠스틱 기타 루프, 보컬 없음\", \"length\": 60, \"version\": \"lyria-3-pro\"}, \"out_task_id\": \"flow_music_gen_123456\"}";

        struct curl_slist *headers = NULL;
        headers = curl_slist_append(headers, "Authorization: Bearer <token>");
        headers = curl_slist_append(headers, "Content-Type: application/json");

        curl_easy_setopt(curl, CURLOPT_URL, url);
        curl_easy_setopt(curl, CURLOPT_POSTFIELDS, payload);
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);

        res = curl_easy_perform(curl);

        if(res != CURLE_OK) {
            fprintf(stderr, "curl_easy_perform() 실패: %s\n",
                    curl_easy_strerror(res));
        }

        curl_slist_free_all(headers);
        curl_easy_cleanup(curl);
    }

    curl_global_cleanup();
    return 0;
}

#import <Foundation/Foundation.h>

int main(int argc, const char * argv[]) {
    @autoreleasepool {
        NSURL *url = [NSURL URLWithString:@"https://aireiter.com/api/openapi/submit"];

        NSDictionary *payload = @{
            @"model": @"flow_music",
            @"params": @{
                @"prompt": @"짧은 어쿠스틱 기타 루프, 보컬 없음",
                @"length": @60,
                @"version": @"lyria-3-pro",
            },
            @"out_task_id": @"flow_music_gen_123456"
        };

        NSError *error;
        NSData *jsonData = [NSJSONSerialization dataWithJSONObject:payload
                                                          options:0
                                                            error:&error];

        NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
        [request setHTTPMethod:@"POST"];
        [request setValue:@"Bearer <token>" forHTTPHeaderField:@"Authorization"];
        [request setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];
        [request setHTTPBody:jsonData];

        NSURLSessionDataTask *task = [[NSURLSession sharedSession]
            dataTaskWithRequest:request
            completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
                if (error) {
                    NSLog(@"오류: %@", error);
                    return;
                }
                NSString *result = [[NSString alloc] initWithData:data
                                                        encoding:NSUTF8StringEncoding];
                NSLog(@"%@", result);
            }];

        [task resume];
        [[NSRunLoop mainRunLoop] run];
    }
    return 0;
}

(* cohttp 및 yojson 라이브러리가 필요합니다 *)
open Lwt
open Cohttp
open Cohttp_lwt_unix

let url = "https://aireiter.com/api/openapi/submit"

let payload = {|{
"model": "flow_music",
"params": {
  "prompt": "짧은 어쿠스틱 기타 루프, 보컬 없음",
  "length": 60,
  "version": "lyria-3-pro"
},
"out_task_id": "flow_music_gen_123456"
}|}

let () =
  let headers = Header.init ()
    |> fun h -> Header.add h "Authorization" "Bearer <token>"
    |> fun h -> Header.add h "Content-Type" "application/json"
  in
  let body = Cohttp_lwt.Body.of_string payload in

  let response = Client.post ~headers ~body (Uri.of_string url) >>= fun (resp, body) ->
    body |> Cohttp_lwt.Body.to_string >|= fun body_str ->
    print_endline body_str
  in
  Lwt_main.run response

import 'dart:convert';
import 'package:http/http.dart' as http;

void main() async {
  final url = Uri.parse('https://aireiter.com/api/openapi/submit');

  final payload = {
    model: "flow_music",
    params: {
      prompt: "짧은 어쿠스틱 기타 루프, 보컬 없음",
      length: 60,
      version: "lyria-3-pro",
    },
    out_task_id: "flow_music_gen_123456"
  };

  final response = await http.post(
    url,
    headers: {
      'Authorization': 'Bearer <token>',
      'Content-Type': 'application/json'
    },
    body: jsonEncode(payload),
  );

  print(response.body);
}

library(httr)
library(jsonlite)

url <- "https://aireiter.com/api/openapi/submit"

payload <- list(
  model = "flow_music",
  params = list(
    prompt = "짧은 어쿠스틱 기타 루프, 보컬 없음",
    length = 60,
    version = "lyria-3-pro",
  ),
  out_task_id = "flow_music_gen_123456"
)

response <- POST(
  url,
  add_headers(
    Authorization = "Bearer <token>",
    `Content-Type` = "application/json"
  ),
  body = toJSON(payload, auto_unbox = TRUE),
  encode = "raw"
)

cat(content(response, "text"))

{
  "statusCode": 200,
  "message": "",
  "data": {
      "out_task_id": "flow_music_gen_123456",
      "status": "pending",
      "created_at": "2026-08-28T07:44:48.000Z"
  }
}

  {
      "statusCode": 400,
      "message": "요청 매개변수가 유효하지 않습니다",
      "ok": false
  }

{
  "error": {
    "code": 401,
    "message": "인증에 실패했습니다. API 키를 확인하세요"
  }
}

  {
    "error": {
      "code": 433,
      "message": "계정 잔액이 부족합니다. 충전 후 다시 시도하세요"
    }
  }

{
  "error": {
    "code": 500,
    "message": "서버 내부 오류입니다. 잠시 후 다시 시도하세요"
  }
}

Flow Music의 AIReiter 내 모델 이름은 flow_music입니다. 가사, 이어쓰기, 대체, 커버, 분리 트랙, 업로드, 다운로드, MV 생성에는 각각 해당 모델을 사용하세요.

Authorizations

string

필수

모든 API 엔드포인트는 Bearer Token을 사용하여 인증해야 합니다.API Key 가져오기:API Key 관리 페이지에 접속하여 API Key를 가져오세요.사용할 때 요청 헤더에 다음을 추가하세요:

Authorization: Bearer YOUR_API_KEY

Body

string

필수

모델 이름, 고정값으로 사용:

flow_music

object

필수

모델 파라미터 객체.

표시 params 객체 속성

string

필수

스타일 프롬프트. 곡 스타일, 악기, 분위기, 보컬을 설명합니다. lyrics도 함께 입력할 수 있습니다.

string

선택 사항인 가사. 입력하지 않으면 순수한 음악을 생성하거나 모델이 보컬을 자체적으로 처리합니다.

string

선택 사항인 곡 제목.

string

선택 사항인 BPM, 1 이상입니다. 문자열로 전달하세요. 예: "120".

number

기본값:"60"

희망 길이, 단위는 초이며 범위는 1에서 240입니다. 참고용일 뿐이며, 상위 시스템이 반드시 이 초 수에 맞춰 결과를 생성하는 것은 아닙니다. 과금은 횟수 기준이며, 길이 기준이 아닙니다.

string

기본값:"lyria-3-pro"

Lyria 버전, 가격은 동일합니다:

lyria-3-pro - 기본값
lyria-3.5 - 업데이트된 보컬 모델

string

필수

호출 측 작업 ID.사용자 정의 작업 식별자이며 필수입니다. 영문자, 숫자, 밑줄, 하이픈만 지원하며 길이는 1-64자입니다. 이후 이 ID로 작업 상태와 결과를 조회할 수 있습니다.

Response

string

요청 측 작업 ID로, 결과를 조회하는 데 사용할 수 있습니다.

string

초기 상태로, 일반적으로 "pending"입니다.

string

생성 시간, ISO 형식입니다.

Query Task

Flow Music은 비동기 음악 생성 모델입니다. 작업을 제출한 후 out_task_id로 작업 상태를 조회하세요. 완료되면 output에는 일반적으로 1개 항목이 포함되며, 필드는 audio(오디오 URL), url(커버 이미지), title, text(가사 일부), clip_id입니다.

string

필수

작업을 제출할 때 전달한 요청자 작업 ID입니다.

curl --request POST \
  --url https://aireiter.com/api/openapi/query \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "out_task_id": "flow_music_gen_123456"
  }'

조회가 성공하고 완료된 후의 output 예시:

{
  "statusCode": 200,
  "message": "",
  "data": {
    "out_task_id": "flow_music_gen_123456",
    "status": "completed",
    "created_at": "2026-08-28T07:44:48.000Z",
    "completed_at": "2026-08-28T07:45:40.000Z",
      "output": [
      {
        "url": "https://static.aireiter.com/tmp/audio-generator/20260828/mmPiP-MSedubqGEZ2Y6Ih-item-0.jpg",
        "audio": "https://static.aireiter.com/tmp/audio-generator/20260828/mmPiP-MSedubqGEZ2Y6Ih-audio-0.m4a",
        "title": "제목 없음",
        "text": "(end - 0:20)",
        "clip_id": "cd984d09-5a77-4a06-9553-e47a55f009b0"
      }
    ]
  }
}

Request Examples

curl --request POST \
  --url https://aireiter.com/api/openapi/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
"model": "flow_music",
"params": {
  "prompt": "짧은 어쿠스틱 기타 루프, 보컬 없음",
  "length": 60,
  "version": "lyria-3-pro"
},
"out_task_id": "flow_music_gen_123456"
}'

import requests

url = "https://aireiter.com/api/openapi/submit"

payload = {
    "model": "flow_music",
    "params": {
      "prompt": "짧은 어쿠스틱 기타 루프, 보컬 없음",
      "length": 60,
      "version": "lyria-3-pro"
},
    "out_task_id": "flow_music_gen_123456"
}

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

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

print(response.json())

const url = "https://aireiter.com/api/openapi/submit";

const payload = {
  model: "flow_music",
  params: {
    "prompt": "짧은 어쿠스틱 기타 루프, 보컬 없음",
    "length": 60,
    "version": "lyria-3-pro"
},
  out_task_id: "flow_music_gen_123456"
};

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));

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io/ioutil"
    "net/http"
)

func main() {
    url := "https://aireiter.com/api/openapi/submit"

    payload := map[string]interface{}{
        "model": "flow_music",
        "params": map[string]interface{}{
            "prompt": "짧은 어쿠스틱 기타 루프, 보컬 없음",
            "length": 60,
            "version": "lyria-3-pro",
        },
        "out_task_id": "flow_music_gen_123456",
    }

    jsonData, _ := json.Marshal(payload)

    req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
    req.Header.Set("Authorization", "Bearer <token>")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := ioutil.ReadAll(resp.Body)
    fmt.Println(string(body))
}

import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class Main {
    public static void main(String[] args) throws Exception {
        String url = "https://aireiter.com/api/openapi/submit";

        String payload = """
{
"model": "flow_music",
"params": {
  "prompt": "짧은 어쿠스틱 기타 루프, 보컬 없음",
  "length": 60,
  "version": "lyria-3-pro"
},
"out_task_id": "flow_music_gen_123456"
}
        """;

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(url))
            .header("Authorization", "Bearer <token>")
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(payload))
            .build();

        HttpResponse<String> response = client.send(request,
            HttpResponse.BodyHandlers.ofString());

        System.out.println(response.body());
    }
}

<?php

$url = "https://aireiter.com/api/openapi/submit";

$payload = [
    "model" => "flow_music",
    "params" => [
        "prompt" => "짧은 어쿠스틱 기타 루프, 보컬 없음",
        "length" => 60,
        "version" => "lyria-3-pro",
    ],
    "out_task_id" => "flow_music_gen_123456"
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

require 'net/http'
require 'json'
require 'uri'

url = URI("https://aireiter.com/api/openapi/submit")

payload = {
  model: "flow_music",
  params: {
    prompt: "짧은 어쿠스틱 기타 루프, 보컬 없음",
    length: 60,
    version: "lyria-3-pro",
  },
  out_task_id: "flow_music_gen_123456"
}

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Post.new(url)
request["Authorization"] = "Bearer <token>"
request["Content-Type"] = "application/json"
request.body = payload.to_json

response = http.request(request)
puts response.body

import Foundation

let url = URL(string: "https://aireiter.com/api/openapi/submit")!

let payload: [String: Any] = [
    "model": "flow_music",
    "params": [
        "prompt": "짧은 어쿠스틱 기타 루프, 보컬 없음",
        "length": 60,
        "version": "lyria-3-pro",
    ],
    "out_task_id": "flow_music_gen_123456"
]

var request = URLRequest(url: url)
request.httpMethod = "POST"
request.setValue("Bearer <token>", forHTTPHeaderField: "Authorization")
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
request.httpBody = try? JSONSerialization.data(withJSONObject: payload)

let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let error = error {
        print("오류: \(error)")
        return
    }

    if let data = data, let responseString = String(data: data, encoding: .utf8) {
        print(responseString)
    }
}

task.resume()

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        var url = "https://aireiter.com/api/openapi/submit";

        var payload = @"
{
""model"": ""flow_music"",
""params"": {
  ""prompt"": ""짧은 어쿠스틱 기타 루프, 보컬 없음"",
  ""length"": 60,
  ""version"": ""lyria-3-pro""
},
""out_task_id"": ""flow_music_gen_123456""
}";

        using var client = new HttpClient();
        client.DefaultRequestHeaders.Add("Authorization", "Bearer <token>");

        var content = new StringContent(payload, Encoding.UTF8, "application/json");
        var response = await client.PostAsync(url, content);
        var result = await response.Content.ReadAsStringAsync();

        Console.WriteLine(result);
    }
}

#include <stdio.h>
#include <curl/curl.h>

int main(void) {
    CURL *curl;
    CURLcode res;

    curl_global_init(CURL_GLOBAL_DEFAULT);
    curl = curl_easy_init();

    if(curl) {
        const char *url = "https://aireiter.com/api/openapi/submit";
        const char *payload = "{\"model\": \"flow_music\", \"params\": {\"prompt\": \"짧은 어쿠스틱 기타 루프, 보컬 없음\", \"length\": 60, \"version\": \"lyria-3-pro\"}, \"out_task_id\": \"flow_music_gen_123456\"}";

        struct curl_slist *headers = NULL;
        headers = curl_slist_append(headers, "Authorization: Bearer <token>");
        headers = curl_slist_append(headers, "Content-Type: application/json");

        curl_easy_setopt(curl, CURLOPT_URL, url);
        curl_easy_setopt(curl, CURLOPT_POSTFIELDS, payload);
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);

        res = curl_easy_perform(curl);

        if(res != CURLE_OK) {
            fprintf(stderr, "curl_easy_perform() 실패: %s\n",
                    curl_easy_strerror(res));
        }

        curl_slist_free_all(headers);
        curl_easy_cleanup(curl);
    }

    curl_global_cleanup();
    return 0;
}

#import <Foundation/Foundation.h>

int main(int argc, const char * argv[]) {
    @autoreleasepool {
        NSURL *url = [NSURL URLWithString:@"https://aireiter.com/api/openapi/submit"];

        NSDictionary *payload = @{
            @"model": @"flow_music",
            @"params": @{
                @"prompt": @"짧은 어쿠스틱 기타 루프, 보컬 없음",
                @"length": @60,
                @"version": @"lyria-3-pro",
            },
            @"out_task_id": @"flow_music_gen_123456"
        };

        NSError *error;
        NSData *jsonData = [NSJSONSerialization dataWithJSONObject:payload
                                                          options:0
                                                            error:&error];

        NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
        [request setHTTPMethod:@"POST"];
        [request setValue:@"Bearer <token>" forHTTPHeaderField:@"Authorization"];
        [request setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];
        [request setHTTPBody:jsonData];

        NSURLSessionDataTask *task = [[NSURLSession sharedSession]
            dataTaskWithRequest:request
            completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
                if (error) {
                    NSLog(@"오류: %@", error);
                    return;
                }
                NSString *result = [[NSString alloc] initWithData:data
                                                        encoding:NSUTF8StringEncoding];
                NSLog(@"%@", result);
            }];

        [task resume];
        [[NSRunLoop mainRunLoop] run];
    }
    return 0;
}

(* cohttp 및 yojson 라이브러리가 필요합니다 *)
open Lwt
open Cohttp
open Cohttp_lwt_unix

let url = "https://aireiter.com/api/openapi/submit"

let payload = {|{
"model": "flow_music",
"params": {
  "prompt": "짧은 어쿠스틱 기타 루프, 보컬 없음",
  "length": 60,
  "version": "lyria-3-pro"
},
"out_task_id": "flow_music_gen_123456"
}|}

let () =
  let headers = Header.init ()
    |> fun h -> Header.add h "Authorization" "Bearer <token>"
    |> fun h -> Header.add h "Content-Type" "application/json"
  in
  let body = Cohttp_lwt.Body.of_string payload in

  let response = Client.post ~headers ~body (Uri.of_string url) >>= fun (resp, body) ->
    body |> Cohttp_lwt.Body.to_string >|= fun body_str ->
    print_endline body_str
  in
  Lwt_main.run response

import 'dart:convert';
import 'package:http/http.dart' as http;

void main() async {
  final url = Uri.parse('https://aireiter.com/api/openapi/submit');

  final payload = {
    model: "flow_music",
    params: {
      prompt: "짧은 어쿠스틱 기타 루프, 보컬 없음",
      length: 60,
      version: "lyria-3-pro",
    },
    out_task_id: "flow_music_gen_123456"
  };

  final response = await http.post(
    url,
    headers: {
      'Authorization': 'Bearer <token>',
      'Content-Type': 'application/json'
    },
    body: jsonEncode(payload),
  );

  print(response.body);
}

library(httr)
library(jsonlite)

url <- "https://aireiter.com/api/openapi/submit"

payload <- list(
  model = "flow_music",
  params = list(
    prompt = "짧은 어쿠스틱 기타 루프, 보컬 없음",
    length = 60,
    version = "lyria-3-pro",
  ),
  out_task_id = "flow_music_gen_123456"
)

response <- POST(
  url,
  add_headers(
    Authorization = "Bearer <token>",
    `Content-Type` = "application/json"
  ),
  body = toJSON(payload, auto_unbox = TRUE),
  encode = "raw"
)

cat(content(response, "text"))

{
  "statusCode": 200,
  "message": "",
  "data": {
      "out_task_id": "flow_music_gen_123456",
      "status": "pending",
      "created_at": "2026-08-28T07:44:48.000Z"
  }
}

  {
      "statusCode": 400,
      "message": "요청 매개변수가 유효하지 않습니다",
      "ok": false
  }

{
  "error": {
    "code": 401,
    "message": "인증에 실패했습니다. API 키를 확인하세요"
  }
}

  {
    "error": {
      "code": 433,
      "message": "계정 잔액이 부족합니다. 충전 후 다시 시도하세요"
    }
  }

{
  "error": {
    "code": 500,
    "message": "서버 내부 오류입니다. 잠시 후 다시 시도하세요"
  }
}

Mode Notes

성공 결과의 clip_id는 flow_music_extend / flow_music_replace / flow_music_cover / flow_music_stems / flow_music_download / flow_music_video에 사용됩니다. length는 엄격한 상한이 아닙니다.

개요

이미지 시리즈

비디오 시리즈

오디오 시리즈

텍스트 시리즈

작업 관리

Flow Music 음악 생성

Authorizations

Body

Response

Query Task

Request Examples

Mode Notes

​Authorizations

​Body

​Response

​Query Task

​Request Examples

​Mode Notes

Authorizations

Body

Response

Query Task

Request Examples

Mode Notes