開發者文檔

圖片生成

向目錄中的圖片模型請求一張圖片,並讀取它回傳的 URL 或 base64 內容。

Requesting an image

圖片模型和文字模型一樣以同步方式回應 —— 一次請求,一次回應,不需輪詢。請求送往 /v1/images/generations,只需要一個模型與一個提示詞。

1from openai import OpenAI23client = OpenAI(4    base_url="https://www.realrelay.ai/v1",5    api_key="sk-***",6)78image = client.images.generate(9    model="byteplus/seedream-4-5-251128",10    prompt="A quiet reading room at golden hour",11)1213print(image.data[0].url)

1import OpenAI from "openai";23const client = new OpenAI({4  baseURL: "https://www.realrelay.ai/v1",5  apiKey: process.env.REALRELAY_API_KEY,6});78const image = await client.images.generate({9  model: "byteplus/seedream-4-5-251128",10  prompt: "A quiet reading room at golden hour",11});1213console.log(image.data[0].url);

1curl https://www.realrelay.ai/v1/images/generations \2  -H "Authorization: Bearer $REALRELAY_API_KEY" \3  -H "Content-Type: application/json" \4  -d '{5    "model": "byteplus/seedream-4-5-251128",6    "prompt": "A quiet reading room at golden hour"7  }'

size、quality、 n 與 response_format 都可接受,廠商專屬的欄位則會原封不動地轉發。特定模型支援哪些值,是由模型供應商決定,而非我們;因此在仰賴某個值之前, 請先查閱該供應商自己的參考文件。

目錄中有些圖片模型尚未宣告此端點,因此它們的目錄條目也不會顯示呼叫範例。那是我們發布內容上的缺口,並不表示該模型無法生成圖片 —— 在我們修正的期間,請向支援團隊詢問確切的呼叫方式。

Reading the response

回應會帶有一個 data 陣列。每個條目視模型與 response_format 而定,會帶有一個 url 或一段 b64_json 內容。請兩者都處理:我們是直接把供應商的回應傳遞出來,而不加以正規化,因此會回傳 base64 的模型會持續這麼做。

1{2"created": 1754899200,3"data": [4  { "url": "https://..." }5]6}

回傳的 URL 是供應商的,不是我們的,而且供應商會讓它過期。請把它當成短暫的存取控點:一拿到就盡快把位元組下載下來, 而不要儲存這個連結。

多數圖片模型按次呼叫計價,而非按 token,價格會依尺寸、品質與所請求的圖片數量而異。目錄會顯示每個模型的按次呼叫價格。