--- title: Seedream Text-to-Image url: https://runapi.ai/zh-CN/docs/api/seedream/text-to-image.md canonical: https://runapi.ai/zh-CN/docs/api/seedream/text-to-image locale: zh-CN --- # Seedream Text-to-Image ## 概览 使用支持的模型提交Text to Image请求。使用返回的 Task ID 查询状态，或提供 callback_url 接收下方列出的投递。 ### 快速开始 1. 创建 API Key，并将其设置为 RUNAPI_API_KEY。 2. 选择一个支持的模型，并发送与该模型 Schema 匹配的 POST 请求。 3. 保存返回的任务 ID，随后轮询到终态，或处理下方列出的回调。 ## 端点 POST /api/v1/seedream/text_to_image 基础 URL: https://runapi.ai API 版本: v1 身份验证: Authorization: Bearer YOUR_API_TOKEN ## 支持的模型 打开模型页可查看当前价格、限流和商业使用详情。 - [seedream-4.5-text-to-image](/models/seedream/4.5-text-to-image) - [seedream-5-lite-text-to-image](/models/seedream/5-lite-text-to-image) - [seedream-5-pro-text-to-image](/models/seedream/5-pro-text-to-image) - [seedream-v4-text-to-image](/models/seedream/v4-text-to-image) ## 请求 Schema 字段和允许的取值取决于所选模型。提供 callback_url 后，它会收到下方列出的 Task 投递。 ### seedream-4.5-text-to-image ```json { "aspect_ratio": { "enum": [ "1:1", "4:3", "3:4", "16:9", "9:16", "2:3", "3:2", "21:9" ], "required": true, "type": "string" }, "callback_url": { "type": "string" }, "enable_safety_checker": { "type": "boolean" }, "model": { "type": "string" }, "output_count": { "type": "integer" }, "output_quality": { "enum": [ "basic", "high" ], "required": true, "type": "string" }, "output_resolution": { "type": "string" }, "prompt": { "type": "string" }, "seed": { "type": "integer" } } ``` ### seedream-5-lite-text-to-image ```json { "aspect_ratio": { "enum": [ "1:1", "4:3", "3:4", "16:9", "9:16", "2:3", "3:2", "21:9" ], "required": true, "type": "string" }, "callback_url": { "type": "string" }, "enable_safety_checker": { "type": "boolean" }, "model": { "type": "string" }, "output_count": { "type": "integer" }, "output_format": { "default": "png", "enum": [ "png", "jpeg" ], "type": "string" }, "output_quality": { "enum": [ "basic", "high" ], "required": true, "type": "string" }, "output_resolution": { "type": "string" }, "prompt": { "type": "string" }, "seed": { "type": "integer" } } ``` ### seedream-5-pro-text-to-image ```json { "aspect_ratio": { "enum": [ "1:1", "4:3", "3:4", "16:9", "9:16", "2:3", "3:2", "21:9" ], "required": true, "type": "string" }, "callback_url": { "type": "string" }, "enable_safety_checker": { "type": "boolean" }, "model": { "type": "string" }, "output_format": { "default": "png", "enum": [ "png", "jpeg" ], "type": "string" }, "output_quality": { "enum": [ "basic", "high" ], "required": true, "type": "string" }, "prompt": { "length": true, "max": 5000, "min": 3, "required": true, "type": "string" } } ``` ### seedream-v4-text-to-image ```json { "aspect_ratio": { "enum": [ "1:1", "4:3", "3:4", "3:2", "2:3", "16:9", "9:16", "21:9" ], "type": "string" }, "callback_url": { "type": "string" }, "enable_safety_checker": { "type": "boolean" }, "model": { "type": "string" }, "output_count": { "enum": [ 1, 2, 3, 4, 5, 6 ], "type": "integer" }, "output_quality": { "type": "string" }, "output_resolution": { "enum": [ "1k", "2k", "4k" ], "type": "string" }, "prompt": { "type": "string" }, "seed": { "type": "integer" } } ``` #### 条件规则 当列出的全部条件同时匹配时，应用这些要求。 - **当**: `model` = `seedream-4.5-text-to-image`; **不可提供**: `output_format` - **当**: `model` = `seedream-5-pro-text-to-image`; **不可提供**: `output_resolution`, `output_count`, `seed` - **当**: `model` = `seedream-v4-text-to-image`; **不可提供**: `output_format` ## 创建已接受 HTTP 202 - POST /api/v1/seedream/text_to_image ### 响应 Schema ```json { "properties": { "billing": { "properties": { "refund": { "oneOf": [ { "properties": { "refunded_at": { "type": "string" } }, "required": [ "refunded_at" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "reservation": { "oneOf": [ { "properties": { "amount_cents": { "type": "integer" } }, "required": [ "amount_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "settlement": { "oneOf": [ { "properties": { "amount_micro_cents": { "type": "integer" }, "charged_amount_cents": { "type": "integer" } }, "required": [ "charged_amount_cents", "amount_micro_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] } }, "required": [ "reservation", "settlement", "refund" ], "type": "object", "unevaluatedProperties": false }, "id": { "type": "string" }, "status": { "enum": [ "processing" ], "type": "string" }, "task_replayed": { "type": "boolean" } }, "required": [ "id", "status", "billing" ], "type": "object", "unevaluatedProperties": false } ``` ### 响应示例 ```json { "billing": { "refund": null, "reservation": null, "settlement": null }, "id": "tsk_reference_demo", "status": "processing" } ``` ## 轮询处理中 HTTP 200 - GET /api/v1/seedream/text_to_image/:id ### 响应 Schema ```json { "properties": { "billing": { "properties": { "refund": { "oneOf": [ { "properties": { "refunded_at": { "type": "string" } }, "required": [ "refunded_at" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "reservation": { "oneOf": [ { "properties": { "amount_cents": { "type": "integer" } }, "required": [ "amount_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "settlement": { "oneOf": [ { "properties": { "amount_micro_cents": { "type": "integer" }, "charged_amount_cents": { "type": "integer" } }, "required": [ "charged_amount_cents", "amount_micro_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] } }, "required": [ "reservation", "settlement", "refund" ], "type": "object", "unevaluatedProperties": false }, "id": { "type": "string" }, "status": { "enum": [ "processing" ], "type": "string" } }, "required": [ "id", "status", "billing" ], "type": "object", "unevaluatedProperties": false } ``` ### 响应示例 ```json { "billing": { "refund": null, "reservation": null, "settlement": null }, "id": "tsk_reference_demo", "status": "processing" } ``` ## 轮询已完成 HTTP 200 - GET /api/v1/seedream/text_to_image/:id ### 响应 Schema ```json { "properties": { "billing": { "properties": { "refund": { "oneOf": [ { "properties": { "refunded_at": { "type": "string" } }, "required": [ "refunded_at" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "reservation": { "oneOf": [ { "properties": { "amount_cents": { "type": "integer" } }, "required": [ "amount_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "settlement": { "oneOf": [ { "properties": { "amount_micro_cents": { "type": "integer" }, "charged_amount_cents": { "type": "integer" } }, "required": [ "charged_amount_cents", "amount_micro_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] } }, "required": [ "reservation", "settlement", "refund" ], "type": "object", "unevaluatedProperties": false }, "id": { "type": "string" }, "images": { "items": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object", "unevaluatedProperties": false }, "type": "array" }, "status": { "enum": [ "completed" ], "type": "string" } }, "required": [ "id", "status", "images", "billing" ], "type": "object", "unevaluatedProperties": false } ``` ### 响应示例 ```json { "billing": { "refund": null, "reservation": null, "settlement": null }, "id": "tsk_reference_demo", "images": [ { "url": "https://cdn.runapi.ai/public/samples/image.jpg" } ], "status": "completed" } ``` ## 轮询失败 HTTP 200 - GET /api/v1/seedream/text_to_image/:id ### 响应 Schema ```json { "properties": { "billing": { "properties": { "refund": { "oneOf": [ { "properties": { "refunded_at": { "type": "string" } }, "required": [ "refunded_at" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "reservation": { "oneOf": [ { "properties": { "amount_cents": { "type": "integer" } }, "required": [ "amount_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "settlement": { "oneOf": [ { "properties": { "amount_micro_cents": { "type": "integer" }, "charged_amount_cents": { "type": "integer" } }, "required": [ "charged_amount_cents", "amount_micro_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] } }, "required": [ "reservation", "settlement", "refund" ], "type": "object", "unevaluatedProperties": false }, "error": { "type": "string" }, "id": { "type": "string" }, "status": { "enum": [ "failed" ], "type": "string" } }, "required": [ "id", "status", "error", "billing" ], "type": "object", "unevaluatedProperties": false } ``` ### 响应示例 ```json { "billing": { "refund": null, "reservation": null, "settlement": null }, "error": "Task processing failed.", "id": "tsk_reference_demo", "status": "failed" } ``` ## 客户回调：已完成 HTTP 200 - POST callback_url ### 响应 Schema ```json { "properties": { "id": { "type": "string" }, "images": { "items": { "properties": { "url": { "type": "string" } }, "required": [ "url" ], "type": "object", "unevaluatedProperties": false }, "type": "array" }, "status": { "enum": [ "completed" ], "type": "string" } }, "required": [ "id", "status", "images" ], "type": "object", "unevaluatedProperties": false } ``` ### 响应示例 ```json { "id": "tsk_reference_demo", "images": [ { "url": "https://cdn.runapi.ai/public/samples/image.jpg" } ], "status": "completed" } ``` ## 客户回调：失败 HTTP 200 - POST callback_url ### 响应 Schema ```json { "properties": { "error": { "oneOf": [ { "type": "string" }, { "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object", "unevaluatedProperties": false } ] }, "id": { "type": "string" }, "status": { "enum": [ "failed" ], "type": "string" } }, "required": [ "id", "status", "error" ], "type": "object", "unevaluatedProperties": false } ``` ### 响应示例 ```json { "error": { "code": "generation_failed", "message": "Task processing failed." }, "id": "tsk_reference_demo", "status": "failed" } ``` ## 错误 HTTP 401 - POST /api/v1/seedream/text_to_image 此响应不包含正文。 ## 错误 HTTP 401 - GET /api/v1/seedream/text_to_image/:id 此响应不包含正文。 ## 错误 HTTP 400 - POST /api/v1/seedream/text_to_image ### 响应 Schema ```json { "properties": { "billing": { "properties": { "refund": { "oneOf": [ { "properties": { "refunded_at": { "type": "string" } }, "required": [ "refunded_at" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "reservation": { "oneOf": [ { "properties": { "amount_cents": { "type": "integer" } }, "required": [ "amount_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "settlement": { "oneOf": [ { "properties": { "amount_micro_cents": { "type": "integer" }, "charged_amount_cents": { "type": "integer" } }, "required": [ "charged_amount_cents", "amount_micro_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] } }, "required": [ "reservation", "settlement", "refund" ], "type": "object", "unevaluatedProperties": false }, "error": { "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object", "unevaluatedProperties": false } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false } ``` ### 响应示例 ```json { "error": { "code": "model_must_be_one_of_seedream-4_5-text-to-image_seedream-5-lite-text-to-image_seedream-5-pro-text-to-image_seedream-v4-text-to-image", "message": "model must be one of: seedream-4.5-text-to-image, seedream-5-lite-text-to-image, seedream-5-pro-text-to-image, seedream-v4-text-to-image" } } ``` ## 错误 HTTP 402 - POST /api/v1/seedream/text_to_image ### 响应 Schema ```json { "properties": { "billing": { "properties": { "refund": { "oneOf": [ { "properties": { "refunded_at": { "type": "string" } }, "required": [ "refunded_at" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "reservation": { "oneOf": [ { "properties": { "amount_cents": { "type": "integer" } }, "required": [ "amount_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "settlement": { "oneOf": [ { "properties": { "amount_micro_cents": { "type": "integer" }, "charged_amount_cents": { "type": "integer" } }, "required": [ "charged_amount_cents", "amount_micro_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] } }, "required": [ "reservation", "settlement", "refund" ], "type": "object", "unevaluatedProperties": false }, "error": { "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object", "unevaluatedProperties": false } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false } ``` ### 响应示例 ```json { "error": { "code": "insufficient_balance", "message": "Insufficient balance" } } ``` ## 错误 HTTP 403 - POST /api/v1/seedream/text_to_image ### 响应 Schema ```json { "properties": { "billing": { "properties": { "refund": { "oneOf": [ { "properties": { "refunded_at": { "type": "string" } }, "required": [ "refunded_at" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "reservation": { "oneOf": [ { "properties": { "amount_cents": { "type": "integer" } }, "required": [ "amount_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "settlement": { "oneOf": [ { "properties": { "amount_micro_cents": { "type": "integer" }, "charged_amount_cents": { "type": "integer" } }, "required": [ "charged_amount_cents", "amount_micro_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] } }, "required": [ "reservation", "settlement", "refund" ], "type": "object", "unevaluatedProperties": false }, "error": { "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object", "unevaluatedProperties": false } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false } ``` ### 响应示例 ```json { "error": { "code": "api_token_credit_limit_exceeded", "message": "API key credit limit exceeded" } } ``` ## 错误 HTTP 409 - POST /api/v1/seedream/text_to_image ### 响应 Schema ```json { "properties": { "billing": { "properties": { "refund": { "oneOf": [ { "properties": { "refunded_at": { "type": "string" } }, "required": [ "refunded_at" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "reservation": { "oneOf": [ { "properties": { "amount_cents": { "type": "integer" } }, "required": [ "amount_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "settlement": { "oneOf": [ { "properties": { "amount_micro_cents": { "type": "integer" }, "charged_amount_cents": { "type": "integer" } }, "required": [ "charged_amount_cents", "amount_micro_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] } }, "required": [ "reservation", "settlement", "refund" ], "type": "object", "unevaluatedProperties": false }, "error": { "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object", "unevaluatedProperties": false } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false } ``` ### 响应示例 ```json { "error": { "code": "request_conflict", "message": "The request uses features that are not supported for the selected model" } } ``` ## 错误 HTTP 429 - POST /api/v1/seedream/text_to_image ### 响应 Schema ```json { "properties": { "billing": { "properties": { "refund": { "oneOf": [ { "properties": { "refunded_at": { "type": "string" } }, "required": [ "refunded_at" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "reservation": { "oneOf": [ { "properties": { "amount_cents": { "type": "integer" } }, "required": [ "amount_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "settlement": { "oneOf": [ { "properties": { "amount_micro_cents": { "type": "integer" }, "charged_amount_cents": { "type": "integer" } }, "required": [ "charged_amount_cents", "amount_micro_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] } }, "required": [ "reservation", "settlement", "refund" ], "type": "object", "unevaluatedProperties": false }, "error": { "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object", "unevaluatedProperties": false } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false } ``` ### 响应示例 ```json { "error": { "code": "rate_limited", "message": "Rate limit reached. Please retry later." } } ``` ## 错误 HTTP 503 - POST /api/v1/seedream/text_to_image ### 响应 Schema ```json { "properties": { "billing": { "properties": { "refund": { "oneOf": [ { "properties": { "refunded_at": { "type": "string" } }, "required": [ "refunded_at" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "reservation": { "oneOf": [ { "properties": { "amount_cents": { "type": "integer" } }, "required": [ "amount_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "settlement": { "oneOf": [ { "properties": { "amount_micro_cents": { "type": "integer" }, "charged_amount_cents": { "type": "integer" } }, "required": [ "charged_amount_cents", "amount_micro_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] } }, "required": [ "reservation", "settlement", "refund" ], "type": "object", "unevaluatedProperties": false }, "error": { "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object", "unevaluatedProperties": false } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false } ``` ### 响应示例 ```json { "error": { "code": "service_unavailable", "message": "Service under maintenance, please try again later" } } ``` ## 错误 HTTP 504 - POST /api/v1/seedream/text_to_image ### 响应 Schema ```json { "properties": { "billing": { "properties": { "refund": { "oneOf": [ { "properties": { "refunded_at": { "type": "string" } }, "required": [ "refunded_at" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "reservation": { "oneOf": [ { "properties": { "amount_cents": { "type": "integer" } }, "required": [ "amount_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "settlement": { "oneOf": [ { "properties": { "amount_micro_cents": { "type": "integer" }, "charged_amount_cents": { "type": "integer" } }, "required": [ "charged_amount_cents", "amount_micro_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] } }, "required": [ "reservation", "settlement", "refund" ], "type": "object", "unevaluatedProperties": false }, "error": { "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object", "unevaluatedProperties": false } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false } ``` ### 响应示例 ```json { "billing": { "refund": null, "reservation": null, "settlement": null }, "error": { "code": "timeout_error", "message": "The request timed out" } } ``` ## 错误 HTTP 404 - GET /api/v1/seedream/text_to_image/:id ### 响应 Schema ```json { "properties": { "billing": { "properties": { "refund": { "oneOf": [ { "properties": { "refunded_at": { "type": "string" } }, "required": [ "refunded_at" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "reservation": { "oneOf": [ { "properties": { "amount_cents": { "type": "integer" } }, "required": [ "amount_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] }, "settlement": { "oneOf": [ { "properties": { "amount_micro_cents": { "type": "integer" }, "charged_amount_cents": { "type": "integer" } }, "required": [ "charged_amount_cents", "amount_micro_cents" ], "type": "object", "unevaluatedProperties": false }, { "enum": [ null ] } ] } }, "required": [ "reservation", "settlement", "refund" ], "type": "object", "unevaluatedProperties": false }, "error": { "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object", "unevaluatedProperties": false } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false } ``` ### 响应示例 ```json { "error": { "code": "not_found", "message": "Task with id 'tsk_reference_demo' not found" } } ``` ## 生成的代码示例 直接使用 cURL，或安装所用语言的 SDK。每个示例都会提交本参考中经过验证的请求。 ### curl ```curl curl -X POST https://runapi.ai/api/v1/seedream/text_to_image \ -H 'Authorization: Bearer YOUR_API_TOKEN' \ -H 'Content-Type: application/json' \ -d '{"model":"seedream-5-pro-text-to-image","prompt":"A cobalt vase on white marble.","aspect_ratio":"1:1","output_quality":"high"}' ``` ### javascript #### 安装 ```bash npm install @runapi.ai/seedream ``` ```javascript import { SeedreamClient } from "@runapi.ai/seedream"; const client = new SeedreamClient({ apiKey: process.env.RUNAPI_API_KEY }); const task = await client.textToImage.create({ "model": "seedream-5-pro-text-to-image", "prompt": "A cobalt vase on white marble.", "aspect_ratio": "1:1", "output_quality": "high" }); ``` ### python #### 安装 ```bash pip install runapi-seedream ``` ```python import os from runapi.seedream import SeedreamClient client = SeedreamClient(api_key=os.environ["RUNAPI_API_KEY"]) task = client.text_to_image.create( model="seedream-5-pro-text-to-image", prompt="A cobalt vase on white marble.", aspect_ratio="1:1", output_quality="high" ) ``` ### go #### 安装 ```bash go get github.com/runapi-ai/seedream-sdk/go@latest ``` ```go package main import ( "context" "log" "os" "github.com/runapi-ai/core-sdk/go/option" seedream "github.com/runapi-ai/seedream-sdk/go/seedream" ) func main() { client, err := seedream.NewClient(option.WithAPIKey(os.Getenv("RUNAPI_API_KEY"))) if err != nil { log.Fatal(err) } task, err := client.TextToImage.Create(context.Background(), seedream.TextToImageParams{ Model: seedream.SeedreamModel("seedream-5-pro-text-to-image"), Prompt: "A cobalt vase on white marble.", AspectRatio: seedream.AspectRatio("1:1"), OutputQuality: seedream.OutputQuality("high"), }) if err != nil { log.Fatal(err) } _ = task } ``` ### ruby #### 安装 ```bash gem install runapi-seedream ``` ```ruby require "runapi/seedream" client = RunApi::Seedream::Client.new(api_key: ENV.fetch("RUNAPI_API_KEY")) task = client.text_to_image.create( model: "seedream-5-pro-text-to-image", prompt: "A cobalt vase on white marble.", aspect_ratio: "1:1", output_quality: "high" ) ``` ### java #### 安装 ```kotlin implementation("ai.runapi:runapi-seedream") ``` ```java import ai.runapi.seedream.SeedreamClient; import ai.runapi.seedream.types.TextToImageParams; import ai.runapi.core.polling.TaskCreateResponse; public final class Example { public static void main(String[] args) { SeedreamClient client = SeedreamClient.builder() .apiKey(System.getenv("RUNAPI_API_KEY")) .build(); TaskCreateResponse task = client.textToImage().create( TextToImageParams.builder() .model("seedream-5-pro-text-to-image") .prompt("A cobalt vase on white marble.") .aspectRatio("1:1") .outputQuality("high") .build() ); } } ``` ### php #### 安装 ```bash composer require runapi-ai/seedream ``` ```php textToImage->create([ "model" => "seedream-5-pro-text-to-image", "prompt" => "A cobalt vase on white marble.", "aspect_ratio" => "1:1", "output_quality" => "high" ]); ``` ## 相关指南 - [API 身份验证](/docs/guides/authentication) - [快速开始](/docs/guides/task-api/quickstart)