/fal-ai/flux-pro/kontext/text-to-image
▼
Authorization
请在 Header 中加入参数 Authorization,取值为 Bearer 之后拼接令牌
范例:
Authorization: Bearer ********************
官方说明文档: https://fal.ai/models/fal-ai/flux-pro/kontext/text-to-image
请求参数项
请求头参数
Authorization
string
必填
范例: Bearer {{YOUR_API_KEY}}
请求体参数 application/json
prompt
string
必填
产出图像的提示
guidance_scale
number
非必填
CFG(无分类器引导)量表用以衡量您希望模型在寻找相关图像时与提示的贴近程度。缺省值:3.5 范围值:1-20
num_images
integer
非必填
产出的图像数量。缺省值:1 范围值:1-4
output_format
string
非必填
产出图片的格式。缺省值:"jpeg" 兼容 default、png、jpeg
safety_tolerance
string
非必填
产出图像的安全容差等级。1 表示最严格,5 表示最宽松。缺省值:"2"
aspect_ratio
string
非必填
产出图像的宽高比。缺省值:"1:1" 兼容:21:9、16:9、4:3、3:2、1:1、2:3、3:4、9:16、9:21
范例
{
"prompt": "Extreme close-up of a single tiger eye, direct frontal view. Detailed iris and pupil. Sharp focus on eye texture and color. Natural lighting to capture authentic eye shine and depth. The word \"FLUX\" is painted over it in big, white brush strokes with visible texture.",
"guidance_scale": 3.5,
"num_images": 1,
"output_format": "jpeg",
"safety_tolerance": "2",
"aspect_ratio": "1:1"
}
请求代码示例
curl --location --request POST 'https://api.timrouter.com/fal-ai/flux-pro/kontext/text-to-image' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
"prompt": "Extreme close-up of a single tiger eye, direct frontal view. Detailed iris and pupil. Sharp focus on eye texture and color. Natural lighting to capture authentic eye shine and depth. The word \"FLUX\" is painted over it in big, white brush strokes with visible texture.",
"guidance_scale": 3.5,
"num_images": 1,
"output_format": "jpeg",
"safety_tolerance": "2",
"aspect_ratio": "1:1"
}'
var myHeaders = new Headers();
myHeaders.append("Accept", "application/json");
myHeaders.append("Authorization", "Bearer YOUR_API_KEY");
myHeaders.append("Content-Type", "application/json");
var raw = JSON.stringify({
"prompt": "Extreme close-up of a single tiger eye, direct frontal view. Detailed iris and pupil. Sharp focus on eye texture and color. Natural lighting to capture authentic eye shine and depth. The word \"FLUX\" is painted over it in big, white brush strokes with visible texture.",
"guidance_scale": 3.5,
"num_images": 1,
"output_format": "jpeg",
"safety_tolerance": "2",
"aspect_ratio": "1:1"
});
var requestOptions = {
method: 'POST',
headers: myHeaders,
body: raw,
redirect: 'follow'
};
fetch("https://api.timrouter.com/fal-ai/flux-pro/kontext/text-to-image", 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.timrouter.com/fal-ai/flux-pro/kontext/text-to-image");
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("POST");
conn.setRequestProperty("Accept", "application/json");
conn.setRequestProperty("Authorization", "Bearer YOUR_API_KEY");
conn.setRequestProperty("Content-Type", "application/json");
conn.setDoOutput(true);
String jsonInputString = "{
\"prompt\": \"Extreme close-up of a single tiger eye, direct frontal view. Detailed iris and pupil. Sharp focus on eye texture and color. Natural lighting to capture authentic eye shine and depth. The word \\"FLUX\\" is painted over it in big, white brush strokes with visible texture.\",
\"guidance_scale\": 3.5,
\"num_images\": 1,
\"output_format\": \"jpeg\",
\"safety_tolerance\": \"2\",
\"aspect_ratio\": \"1:1\"
}";
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.timrouter.com/fal-ai/flux-pro/kontext/text-to-image"
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")
request.addValue("application/json", forHTTPHeaderField: "Content-Type")
let httpBody = "{
\"prompt\": \"Extreme close-up of a single tiger eye, direct frontal view. Detailed iris and pupil. Sharp focus on eye texture and color. Natural lighting to capture authentic eye shine and depth. The word \\"FLUX\\" is painted over it in big, white brush strokes with visible texture.\",
\"guidance_scale\": 3.5,
\"num_images\": 1,
\"output_format\": \"jpeg\",
\"safety_tolerance\": \"2\",
\"aspect_ratio\": \"1:1\"
}"
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(`{
"prompt": "Extreme close-up of a single tiger eye, direct frontal view. Detailed iris and pupil. Sharp focus on eye texture and color. Natural lighting to capture authentic eye shine and depth. The word \"FLUX\" is painted over it in big, white brush strokes with visible texture.",
"guidance_scale": 3.5,
"num_images": 1,
"output_format": "jpeg",
"safety_tolerance": "2",
"aspect_ratio": "1:1"
}`)
req, _ := http.NewRequest("POST", "https://api.timrouter.com/fal-ai/flux-pro/kontext/text-to-image", body)
req.Header.Set("Accept", "application/json")
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
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.timrouter.com/fal-ai/flux-pro/kontext/text-to-image',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS => '{
"prompt": "Extreme close-up of a single tiger eye, direct frontal view. Detailed iris and pupil. Sharp focus on eye texture and color. Natural lighting to capture authentic eye shine and depth. The word \"FLUX\" is painted over it in big, white brush strokes with visible texture.",
"guidance_scale": 3.5,
"num_images": 1,
"output_format": "jpeg",
"safety_tolerance": "2",
"aspect_ratio": "1:1"
}',
CURLOPT_HTTPHEADER => array(
"Accept: application/json",
"Authorization: Bearer YOUR_API_KEY",
"Content-Type: application/json",
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
import http.client
import json
conn = http.client.HTTPSConnection("api.timrouter.com")
payload = json.dumps({
"prompt": "Extreme close-up of a single tiger eye, direct frontal view. Detailed iris and pupil. Sharp focus on eye texture and color. Natural lighting to capture authentic eye shine and depth. The word \"FLUX\" is painted over it in big, white brush strokes with visible texture.",
"guidance_scale": 3.5,
"num_images": 1,
"output_format": "jpeg",
"safety_tolerance": "2",
"aspect_ratio": "1:1"
})
headers = {
'Accept': 'application/json',
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
}
conn.request("POST", "/fal-ai/flux-pro/kontext/text-to-image", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
POST https://api.timrouter.com/fal-ai/flux-pro/kontext/text-to-image HTTP/1.1
Accept: application/json
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
{
"prompt": "Extreme close-up of a single tiger eye, direct frontal view. Detailed iris and pupil. Sharp focus on eye texture and color. Natural lighting to capture authentic eye shine and depth. The word \"FLUX\" is painted over it in big, white brush strokes with visible texture.",
"guidance_scale": 3.5,
"num_images": 1,
"output_format": "jpeg",
"safety_tolerance": "2",
"aspect_ratio": "1:1"
}
CURL *hnd = curl_easy_init();
curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "POST");
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.timrouter.com/fal-ai/flux-pro/kontext/text-to-image");
struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Accept: application/json");
headers = curl_slist_append(headers, "Authorization: Bearer YOUR_API_KEY");
headers = curl_slist_append(headers, "Content-Type: application/json");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);
curl_easy_setopt(hnd, CURLOPT_POSTFIELDS, "{
\"prompt\": \"Extreme close-up of a single tiger eye, direct frontal view. Detailed iris and pupil. Sharp focus on eye texture and color. Natural lighting to capture authentic eye shine and depth. The word \\"FLUX\\" is painted over it in big, white brush strokes with visible texture.\",
\"guidance_scale\": 3.5,
\"num_images\": 1,
\"output_format\": \"jpeg\",
\"safety_tolerance\": \"2\",
\"aspect_ratio\": \"1:1\"
}");
CURLcode ret = curl_easy_perform(hnd);
var client = new RestClient("https://api.timrouter.com/fal-ai/flux-pro/kontext/text-to-image");
var request = new RestRequest(Method.POST);
request.AddHeader("Accept", "application/json");
request.AddHeader("Authorization", "Bearer YOUR_API_KEY");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", @"{
"prompt": "Extreme close-up of a single tiger eye, direct frontal view. Detailed iris and pupil. Sharp focus on eye texture and color. Natural lighting to capture authentic eye shine and depth. The word \"FLUX\" is painted over it in big, white brush strokes with visible texture.",
"guidance_scale": 3.5,
"num_images": 1,
"output_format": "jpeg",
"safety_tolerance": "2",
"aspect_ratio": "1:1"
}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
#import <Foundation/Foundation.h>
NSURL *url = [NSURL URLWithString:@"https://api.timrouter.com/fal-ai/flux-pro/kontext/text-to-image"];
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
[request setHTTPMethod:@"POST"];
[request setValue:@"application/json" forHTTPHeaderField:@"Accept"];
[request setValue:@"Bearer YOUR_API_KEY" forHTTPHeaderField:@"Authorization"];
[request setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];
[request setHTTPBody:[@"{
\"prompt\": \"Extreme close-up of a single tiger eye, direct frontal view. Detailed iris and pupil. Sharp focus on eye texture and color. Natural lighting to capture authentic eye shine and depth. The word \\"FLUX\\" is painted over it in big, white brush strokes with visible texture.\",
\"guidance_scale\": 3.5,
\"num_images\": 1,
\"output_format\": \"jpeg\",
\"safety_tolerance\": \"2\",
\"aspect_ratio\": \"1:1\"
}" 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.timrouter.com/fal-ai/flux-pro/kontext/text-to-image")
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["Content-Type"] = "application/json"
request.body = '{
"prompt": "Extreme close-up of a single tiger eye, direct frontal view. Detailed iris and pupil. Sharp focus on eye texture and color. Natural lighting to capture authentic eye shine and depth. The word \"FLUX\" is painted over it in big, white brush strokes with visible texture.",
"guidance_scale": 3.5,
"num_images": 1,
"output_format": "jpeg",
"safety_tolerance": "2",
"aspect_ratio": "1:1"
}'
response = http.request(request)
puts response.read_body
(* Requires cohttp and lwt *)
let url = "https://api.timrouter.com/fal-ai/flux-pro/kontext/text-to-image" in
let headers = Cohttp.Header.of_list [
("Accept", "application/json");
("Authorization", "Bearer YOUR_API_KEY");
("Content-Type", "application/json");
] in
let body = Cohttp_lwt.Body.of_string '{
"prompt": "Extreme close-up of a single tiger eye, direct frontal view. Detailed iris and pupil. Sharp focus on eye texture and color. Natural lighting to capture authentic eye shine and depth. The word \"FLUX\" is painted over it in big, white brush strokes with visible texture.",
"guidance_scale": 3.5,
"num_images": 1,
"output_format": "jpeg",
"safety_tolerance": "2",
"aspect_ratio": "1:1"
}' 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",
"Content-Type": "application/json",
};
var body = json.encode({
"prompt": "Extreme close-up of a single tiger eye, direct frontal view. Detailed iris and pupil. Sharp focus on eye texture and color. Natural lighting to capture authentic eye shine and depth. The word \"FLUX\" is painted over it in big, white brush strokes with visible texture.",
"guidance_scale": 3.5,
"num_images": 1,
"output_format": "jpeg",
"safety_tolerance": "2",
"aspect_ratio": "1:1"
});
var response = await http.post(Uri.parse("https://api.timrouter.com/fal-ai/flux-pro/kontext/text-to-image"), headers: headers, body: body);
print(response.body);
library(httr)
url <- "https://api.timrouter.com/fal-ai/flux-pro/kontext/text-to-image"
body <- '{
"prompt": "Extreme close-up of a single tiger eye, direct frontal view. Detailed iris and pupil. Sharp focus on eye texture and color. Natural lighting to capture authentic eye shine and depth. The word \"FLUX\" is painted over it in big, white brush strokes with visible texture.",
"guidance_scale": 3.5,
"num_images": 1,
"output_format": "jpeg",
"safety_tolerance": "2",
"aspect_ratio": "1:1"
}'
response <- post(url, body = body, add_headers("Accept" = "application/json", "Authorization" = "Bearer YOUR_API_KEY", "Content-Type" = "application/json"))
content(response, "text", encoding = "UTF-8")
返回
返回参数 application/json
status
string
非必填
任务情况
request_id
string
非必填
请求ID
response_url
string
非必填
取得结果的URL
status_url
string
非必填
状态检索URL
cancel_url
string
非必填
取消作业URL
logs
null
非必填
日志
metrics
object
非必填
指标数据
queue_position
integer
非必填
队列位置
范例
{
"status": "IN_QUEUE",
"request_id": "acf05732-7cb3-445b-9f39-fdaeccb1d730",
"response_url": "https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730",
"status_url": "https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730/status",
"cancel_url": "https://queue.fal.run/fal-ai/flux-pro/requests/acf05732-7cb3-445b-9f39-fdaeccb1d730/cancel",
"logs": null,
"metrics": {},
"queue_position": 0
}