Ideogram Remix 混合接口 - QuickRouter API 中转接口
▼
Authorization
在 Header 添加参数 Authorization,其值为 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
官方文档:https://developer.ideogram.ai/api-reference/api-reference/remix
请求参数
Header 参数
Content-Type
string
必需
示例: multipart/form-data
Accept
string
必需
示例: application/json
Authorization
string
必需
示例: Bearer {{YOUR_API_KEY}}
Body 参数 application/json
multipart/form-data
可选
image_request
string
可选
"prompt": "a beautiful sunset over mountains", // 用于生成图像的提示词 (必填) "aspect_ratio": "ASPECT_16_9", // 图像宽高比 (可选) 可选值:ASPECT_10_16/ASPECT_16_10/ASPECT_9_16/ASPECT_16_9/ASPECT_3_2/ASPECT_2_3/ASPECT_4_3/ASPECT_3_4/ASPECT_1_1/ASPECT_1_3/ASPECT_3_1 "color_palette": { // 颜色调色板 (可选) "name": "FRESH" // 预设调色板名称 (与members二选一) 可选值:EMBER/FRESH/JUNGLE/MAGIC/MELON/MOSAIC/PASTEL/ULTRAMARINE // 或者使用自定义颜色: /"members": [ { "color_hex": "#FF0000", // 颜色十六进制值 (必填) "color_weight": 1.0 // 颜色权重 (可选) 范围:0.05-1.0 } ]/ }, "image_weight": 50, // 图像权重 (可选) 范围:1-100,默认50 "magic_prompt_option": "AUTO", // 是否使用MagicPrompt (可选) 可选值:AUTO/ON/OFF "model": "V_2", // 使用的模型 (可选) 默认V_2,可选值:V_1/V_1_TURBO/V_2/V_2_TURBO "negative_prompt": "clouds,blur", // 反向提示词 (可选) 描述不想在图像中出现的内容 "num_images": 1, // 生成图片数量 (可选) 范围:1-8,默认1 "resolution": "RESOLUTION_1024_1024", // 分辨率 (可选) 可选值包含从512x1536到1536x640等多种分辨率组合 "seed": 123456, // 随机种子 (可选) 范围:0-2147483647 "style_type": "REALISTIC" // 风格类型 (可选) 可选值:AUTO/GENERAL/REALISTIC/DESIGN/RENDER_3D/ANIME 示例: { "image_weight": 50, "model": "V_1", "magic_prompt_option": "AUTO", "prompt": "A%20serene%20tropical%20beach%20", "aspect_ratio": "ASPECT_10_16", "seed": 12345, "negative_prompt": "brush%20strokes%2C%20painting"}
image_file
file
可选
图片文件 (必填) 用于生成新图像的源图片文件 示例: file://C:\Users\Administrator\Desktop\例子.png 请求
示例
{
"code": 0,
"message": "SUCCEED",
"request_id": "CjMT7WdSwWcAAAAAALvB3g",
"data": {
"task_id": "CjMT7WdSwWcAAAAAALvB3g",
"task_status": "submitted",
"created_at": 1733851336696,
"updated_at": 1733851336696
}
}
请求示例代码
{
"prompt": "a beautiful image",
"model": "ideogram-3"
}
curl --location --request POST 'https://api.quickrouter.ai/ideogram/remix' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data-raw '{
"code": 0,
"message": "SUCCEED",
"request_id": "CjMT7WdSwWcAAAAAALvB3g",
"data": {
"task_id": "CjMT7WdSwWcAAAAAALvB3g",
"task_status": "submitted",
"created_at": 1733851336696,
"updated_at": 1733851336696
}
}'
var myHeaders = new Headers();
myHeaders.append("Accept", "application/json");
myHeaders.append("Authorization", "Bearer YOUR_API_KEY");
var raw = JSON.stringify({
"code": 0,
"message": "SUCCEED",
"request_id": "CjMT7WdSwWcAAAAAALvB3g",
"data": {
"task_id": "CjMT7WdSwWcAAAAAALvB3g",
"task_status": "submitted",
"created_at": 1733851336696,
"updated_at": 1733851336696
}
});
var requestOptions = {
method: 'POST',
headers: myHeaders,
body: raw,
redirect: 'follow'
};
fetch("https://api.quickrouter.ai/ideogram/remix", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));
import java.io.*;
import java.net.*;
import java.util.*;
URL url = new URL("https://api.quickrouter.ai/ideogram/remix");
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("POST");
conn.setRequestProperty("Accept", "application/json");
conn.setRequestProperty("Authorization", "Bearer YOUR_API_KEY");
conn.setDoOutput(true);
String jsonInputString = "{
\"code\": 0,
\"message\": \"SUCCEED\",
\"request_id\": \"CjMT7WdSwWcAAAAAALvB3g\",
\"data\": {
\"task_id\": \"CjMT7WdSwWcAAAAAALvB3g\",
\"task_status\": \"submitted\",
\"created_at\": 1733851336696,
\"updated_at\": 1733851336696
}
}";
try(OutputStream os = conn.getOutputStream()) {
byte[] input = jsonInputString.getBytes("utf-8");
os.write(input, 0, input.length);
}
int responseCode = conn.getResponseCode();
System.out.println("Response Code: " + responseCode);
import Foundation
let urlString = "https://api.quickrouter.ai/ideogram/remix"
guard let url = URL(string: urlString) else { return }
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.addValue("application/json", forHTTPHeaderField: "Accept")
request.addValue("Bearer YOUR_API_KEY", forHTTPHeaderField: "Authorization")
let httpBody = "{
\"code\": 0,
\"message\": \"SUCCEED\",
\"request_id\": \"CjMT7WdSwWcAAAAAALvB3g\",
\"data\": {
\"task_id\": \"CjMT7WdSwWcAAAAAALvB3g\",
\"task_status\": \"submitted\",
\"created_at\": 1733851336696,
\"updated_at\": 1733851336696
}
}"
request.httpBody = httpBody.data(using: .utf8)
let task = URLSession.shared.dataTask(with: request) { data, response, error in
if let data = data {
print(String(data: data, encoding: .utf8)!)
}
}
task.resume()
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
body := strings.NewReader(`{
"code": 0,
"message": "SUCCEED",
"request_id": "CjMT7WdSwWcAAAAAALvB3g",
"data": {
"task_id": "CjMT7WdSwWcAAAAAALvB3g",
"task_status": "submitted",
"created_at": 1733851336696,
"updated_at": 1733851336696
}
}`)
req, _ := http.NewRequest("POST", "https://api.quickrouter.ai/ideogram/remix", body)
req.Header.Set("Accept", "application/json")
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
bodyBytes, _ := io.ReadAll(resp.Body)
fmt.Println(string(bodyBytes))
}
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://api.quickrouter.ai/ideogram/remix',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS => '{
"code": 0,
"message": "SUCCEED",
"request_id": "CjMT7WdSwWcAAAAAALvB3g",
"data": {
"task_id": "CjMT7WdSwWcAAAAAALvB3g",
"task_status": "submitted",
"created_at": 1733851336696,
"updated_at": 1733851336696
}
}',
CURLOPT_HTTPHEADER => array(
"Accept: application/json",
"Authorization: Bearer YOUR_API_KEY",
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
import http.client
import json
conn = http.client.HTTPSConnection("api.quickrouter.ai")
payload = json.dumps({
"code": 0,
"message": "SUCCEED",
"request_id": "CjMT7WdSwWcAAAAAALvB3g",
"data": {
"task_id": "CjMT7WdSwWcAAAAAALvB3g",
"task_status": "submitted",
"created_at": 1733851336696,
"updated_at": 1733851336696
}
})
headers = {
'Accept': 'application/json',
'Authorization': 'Bearer YOUR_API_KEY',
}
conn.request("POST", "/ideogram/remix", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
POST https://api.quickrouter.ai/ideogram/remix HTTP/1.1
Accept: application/json
Authorization: Bearer YOUR_API_KEY
{
"code": 0,
"message": "SUCCEED",
"request_id": "CjMT7WdSwWcAAAAAALvB3g",
"data": {
"task_id": "CjMT7WdSwWcAAAAAALvB3g",
"task_status": "submitted",
"created_at": 1733851336696,
"updated_at": 1733851336696
}
}
CURL *hnd = curl_easy_init();
curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "POST");
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.quickrouter.ai/ideogram/remix");
struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Accept: application/json");
headers = curl_slist_append(headers, "Authorization: Bearer YOUR_API_KEY");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);
curl_easy_setopt(hnd, CURLOPT_POSTFIELDS, "{
\"code\": 0,
\"message\": \"SUCCEED\",
\"request_id\": \"CjMT7WdSwWcAAAAAALvB3g\",
\"data\": {
\"task_id\": \"CjMT7WdSwWcAAAAAALvB3g\",
\"task_status\": \"submitted\",
\"created_at\": 1733851336696,
\"updated_at\": 1733851336696
}
}");
CURLcode ret = curl_easy_perform(hnd);
var client = new RestClient("https://api.quickrouter.ai/ideogram/remix");
var request = new RestRequest(Method.POST);
request.AddHeader("Accept", "application/json");
request.AddHeader("Authorization", "Bearer YOUR_API_KEY");
request.AddParameter("application/json", @"{
"code": 0,
"message": "SUCCEED",
"request_id": "CjMT7WdSwWcAAAAAALvB3g",
"data": {
"task_id": "CjMT7WdSwWcAAAAAALvB3g",
"task_status": "submitted",
"created_at": 1733851336696,
"updated_at": 1733851336696
}
}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
#import <Foundation/Foundation.h>
NSURL *url = [NSURL URLWithString:@"https://api.quickrouter.ai/ideogram/remix"];
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
[request setHTTPMethod:@"POST"];
[request setValue:@"application/json" forHTTPHeaderField:@"Accept"];
[request setValue:@"Bearer YOUR_API_KEY" forHTTPHeaderField:@"Authorization"];
[request setHTTPBody:[@"{
\"code\": 0,
\"message\": \"SUCCEED\",
\"request_id\": \"CjMT7WdSwWcAAAAAALvB3g\",
\"data\": {
\"task_id\": \"CjMT7WdSwWcAAAAAALvB3g\",
\"task_status\": \"submitted\",
\"created_at\": 1733851336696,
\"updated_at\": 1733851336696
}
}" dataUsingEncoding:NSUTF8StringEncoding]];
NSURLSessionDataTask *task = [[NSURLSession sharedSession] dataTaskWithRequest:request completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
NSLog(@"%@", [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding]);
}];
[task resume];
require "uri"
require "net/http"
require "json"
url = URI("https://api.quickrouter.ai/ideogram/remix")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Accept"] = "application/json"
request["Authorization"] = "Bearer YOUR_API_KEY"
request.body = '{
"code": 0,
"message": "SUCCEED",
"request_id": "CjMT7WdSwWcAAAAAALvB3g",
"data": {
"task_id": "CjMT7WdSwWcAAAAAALvB3g",
"task_status": "submitted",
"created_at": 1733851336696,
"updated_at": 1733851336696
}
}'
response = http.request(request)
puts response.read_body
(* Requires cohttp and lwt *)
let url = "https://api.quickrouter.ai/ideogram/remix" in
let headers = Cohttp.Header.of_list [
("Accept", "application/json");
("Authorization", "Bearer YOUR_API_KEY");
] in
let body = Cohttp_lwt.Body.of_string '{
"code": 0,
"message": "SUCCEED",
"request_id": "CjMT7WdSwWcAAAAAALvB3g",
"data": {
"task_id": "CjMT7WdSwWcAAAAAALvB3g",
"task_status": "submitted",
"created_at": 1733851336696,
"updated_at": 1733851336696
}
}' in
Lwt_main.run (
Cohttp_lwt_unix.Client.request ?body:(Some body) ~method_:`POST ~headers (Uri.of_string url)
>>= fun (resp, body) ->
Cohttp_lwt.Body.to_string body >|= fun s -> print_endline s
)
import 'package:http/http.dart' as http;
import 'dart:convert';
var headers = {
"Accept": "application/json",
"Authorization": "Bearer YOUR_API_KEY",
};
var body = json.encode({
"code": 0,
"message": "SUCCEED",
"request_id": "CjMT7WdSwWcAAAAAALvB3g",
"data": {
"task_id": "CjMT7WdSwWcAAAAAALvB3g",
"task_status": "submitted",
"created_at": 1733851336696,
"updated_at": 1733851336696
}
});
var response = await http.post(Uri.parse("https://api.quickrouter.ai/ideogram/remix"), headers: headers, body: body);
print(response.body);
library(httr)
url <- "https://api.quickrouter.ai/ideogram/remix"
body <- '{
"code": 0,
"message": "SUCCEED",
"request_id": "CjMT7WdSwWcAAAAAALvB3g",
"data": {
"task_id": "CjMT7WdSwWcAAAAAALvB3g",
"task_status": "submitted",
"created_at": 1733851336696,
"updated_at": 1733851336696
}
}'
response <- post(url, body = body, add_headers("Accept" = "application/json", "Authorization" = "Bearer YOUR_API_KEY"))
content(response, "text", encoding = "UTF-8")
返回响应
响应参数 🟢 200 OK · application/json
code
integer
必需
message
string
必需
request_id
string
必需
data
object
必需
task_id
string
必需
task_status
string
必需
created_at
integer
必需
updated_at
integer
必需
{ "code": 0, "message": "SUCCEED", "request_id": "CjMT7WdSwWcAAAAAALvB3g", "data": { "task_id": "CjMT7WdSwWcAAAAAALvB3g", "task_status": "submitted", "created_at": 1733851336696, "updated_at": 1733851336696 } }