如何生成图像

从文本提示词生成一张图像。

快速开始

加上 ?sync=true 即可在一次请求中拿到结果：

cURLPythonJavaScript

bash

curl -X POST "https://api.get3w.com/v1/google/nano-banana-pro/text-to-image?sync=true" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A serene Japanese garden with cherry blossoms, golden hour lighting",
    "aspect_ratio": "1:1",
    "resolution": "1k",
    "output_format": "png",
    "channel": "stable"
  }'

python

import requests

response = requests.post(
    "https://api.get3w.com/v1/google/nano-banana-pro/text-to-image?sync=true",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={
        "prompt": "A serene Japanese garden with cherry blossoms, golden hour lighting",
        "aspect_ratio": "1:1",
        "resolution": "1k",
        "output_format": "png",
        "channel": "stable"
    }
)

data = response.json()
print(data["outputs"][0])

javascript

const response = await fetch(
    "https://api.get3w.com/v1/google/nano-banana-pro/text-to-image?sync=true",
    {
        method: "POST",
        headers: {
            "Authorization": "Bearer YOUR_API_KEY",
            "Content-Type": "application/json"
        },
        body: JSON.stringify({
            prompt: "A serene Japanese garden with cherry blossoms, golden hour lighting",
            aspect_ratio: "1:1",
            resolution: "1k",
            output_format: "png",
            channel: "stable"
        })
    }
);

const data = await response.json();
console.log(data.outputs[0]);

选择模型

Slug	适用场景
`google/nano-banana-pro/text-to-image`	综合能力强，速度快
`bytedance/seedream-5-pro/text-to-image`	照片级真实感
`bytedance/seedream-5-lite/text-to-image`	低成本快速迭代
`black-forest-labs/flux-2-pro/text-to-image`	提示词遵循度高，细节丰富
`alibaba/qwen-image-2-pro/text-to-image`	图中文字渲染
`midjourney/v8.2/text-to-image`	风格化、艺术化输出
`recraft/recraft-4.1-vector/text-to-image`	矢量图与 Logo
`ideogram/ideogram-3/text-to-image`	排版与海报

完整模型列表见 get3w.com/models。

常用参数

参数	类型	说明
`prompt`	string	图像的文本描述
`aspect_ratio`	string	画面比例，如 `1:1`、`16:9`、`9:16`
`resolution`	string	输出分辨率，如 `1k`、`2k`
`output_format`	string	文件格式，如 `png`、`jpeg`
`seed`	integer	用于复现结果的随机种子
`channel`	string	服务通道，如 `economy`、`stable`

各模型可接受的取值不同 —— 具体 schema 请查看对应模型页面。传入不支持的值会返回任务码 1401。

提升效果的技巧

描述要具体 —— "A golden retriever playing fetch in a park at sunset" 的效果远好于 "a dog"
加入风格关键词 —— "cinematic"、"photorealistic"、"watercolor"
指定光照 —— "golden hour"、"studio lighting"、"dramatic shadows"
画面比例贴合使用场景 —— 移动端用 9:16，视频封面用 16:9
遇到满意的结果就固定 seed，这样可以在不丢失构图的前提下继续调整提示词

编辑已有图像

把 run type 换成 image-to-image，并传入输入图像：

bash

curl -X POST "https://api.get3w.com/v1/google/nano-banana-pro/image-to-image?sync=true" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Transform into a watercolor painting style",
    "image_urls": ["https://your-cdn.com/your-image.png"]
  }'

输入图像必须放在公网可访问的 URL 上。如果 URL 无法抓取，任务会以 1402 失败。

下一步

如何用图像生成视频 —— 让静态图动起来
如何写出更好的提示词 —— 提升生成效果
如何选择合适的模型 —— 选型指南

如何生成图像 ​

快速开始 ​

选择模型 ​

常用参数 ​

提升效果的技巧 ​

编辑已有图像 ​

下一步 ​