Skip to main content
POST
图片生成

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json

Tikway 标准图片请求。

prompt
string
必填
Minimum string length: 1
model
string
必填

必填。使用 Get Models 返回的模型 ID 或可用别名。

Minimum string length: 1
示例:

"grok-imagine-1.0"

"grok-imagine-2.0"

"grok-imagine-image"

"grok-imagine-image-quality"

"grok-imagine-image-2.0"

enable_pro
boolean

Grok Pro 模式开关,仅支持该参数的模型可用。

n
integer
默认值:1

生成图片数量,1–4。

必填范围: 1 <= x <= 4
size
string

输出宽高比使用 WIDTHxHEIGHT 表示,例如 1024x1536 表示 2:3;auto 使用模型默认比例。分辨率由 quality 控制。

Pattern: ^(auto|[1-9][0-9]*x[1-9][0-9]*)$
response_format
enum<string>
默认值:url

Tikway 图片交付格式,url 返回图片链接,b64_json 返回纯 Base64。默认 url;该字段由网关消费,不作为上游模型参数。

可用选项:
url,
b64_json
quality
enum<string>
默认值:standard

standard 输出 1K,hd 输出 2K;可用能力以所选模型为准。

可用选项:
standard,
hd
images
(string | object)[]

参考图,1–5 张。不支持独立 mask 参数。

Required array length: 1 - 5 elements
Minimum string length: 1

响应

200 - application/json

同步返回统一 Images 结果;response_format 决定返回 url 或 b64_json。

created
integer
必填

Unix 时间戳(秒)。

data
object[]
必填
Minimum array length: 1
model
string

返回时为请求使用的模型 ID。

size
string
output_format
string
quality
string
background
string
usage
object