ShareAI Platform Docs

生成圖片

同步嘅 JSON 回應喺數據入面包含圖像結果。.

以Markdown檢視
喺呢頁面
POST https://api.shareai.now/api/v1/images

生成圖片

基礎 URL
https://api.shareai.now
認證
Bearer API 密鑰或者已批准嘅 OAuth 訪問權杖
必需範圍
inference or monetization_gateway

同步嘅 JSON 回應包含嘅係圖片結果喺 data. 。別名 /api/v1/images/generations 亦都支援。選項例如尺寸、解像度、長寬比、質量同輸出格式取決於所揀嘅模型。回應限制喺 2 MiB;需要時減少圖片數量或者尺寸。返回嘅圖片每邊限制喺 8192 像素。.

開始之前#

喺你嘅伺服器上設置SHAREAI_API_KEY,並將模型佔位符替換成目前啟用嘅模型。千祈唔好喺瀏覽器代碼中暴露API密鑰。模型、賬戶、憑證同供應商都必須允許執行呢個操作。以下嘅可選設置需要模型支持;API安全範圍唔係保證每個模型都支持每個值。.

發送請求#

cURL

curl --fail-with-body --request POST "https://api.shareai.now/api/v1/images" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_ENABLED_IMAGES_MODEL",
  "prompt": "A quiet forest painted in watercolor.",
  "n": 1
}'

請求字段#

字段類型意義同限制
model 必需字符串精確啟用嘅公共模型標識符。必須聲明呢個操作,並且要獲得你嘅憑證允許。.
prompt 必需字符串非空嘅生成提示,最多 256 KiB 嘅 UTF-8 文本。.
n整數可選圖片數量,1–10;默認係 1。你嘅模型可能允許更少數量。.
size字符串模型支持嘅輸出尺寸,最多 100 個字符,例如 1024×1024。唔係每個模型都支持呢個選項。.
resolution字符串模型支持嘅解像度選擇器,最多 100 個字符;必須同發佈嘅收費變體匹配。.
aspect_ratio字符串模型支持嘅長寬比選擇器,最多 100 個字符。.
quality字符串模型支持嘅質量選擇器,最多 100 個字符;可能會選擇唔同嘅速率。.
response_format字符串模型支援嘅回應格式,最多 100 個字符。操作決定結果係 JSON 定係二進制。.
output_format字符串模型支持嘅輸出編碼選擇器,最多 100 個字符。.
background字符串當模型支持時,可選嘅圖片背景設置。.
seed整數可選嘅模型支持嘅種子。視頻需要一個非負整數;可重現性取決於執行器。.
input_references陣列最多 16 個類型化嘅 image_url 部分,image_url.url 必須設置為 HTTPS URL 或支持嘅圖片數據 URL。需要模型支持。.
provider對象可選嘅提供者路由偏好。使用 provider.only 來接受提供者標籤,而唔係模型 ID 嘅前綴。賬戶同憑證限制仍然適用。.

閱讀結果#

成功會返回 HTTP 200 同 JSON。同步嘅 JSON 回應包含嘅係圖片結果喺 data. 。別名 /api/v1/images/generations 亦都支援。選項例如尺寸、解像度、長寬比、質量同輸出格式取決於所揀嘅模型。回應限制喺 2 MiB;需要時減少圖片數量或者尺寸。返回嘅圖片每邊限制喺 8192 像素。.

計費單位#

圖片收費可以使用生成嘅圖片、計算嘅百萬像素、輸入參考、請求或者供應商報告嘅代幣。圖片 URL 唔係圖片尺寸嘅測量。百萬像素收費需要返回嘅圖片尺寸;對於嗰啲路徑,請使用 base64 輸出。.

喺Console中選擇準確啟用嘅模型標識符。佢聲明嘅操作同輸入/輸出能力必須同呢個端點匹配;文字聊天模型唔可以用嚟代替其他操作。你嘅憑證、供應商同賬戶限制仍然適用。.

價格同使用量#

費率以歐元AI點數發佈,適用於所選模型、供應商、單位同變體。只會收取活躍費率中嘅維度。執行前嘅估算會預留點數;最終收費會根據實際使用量計算。價格可能取決於解析度、輸出格式或者使用量區間。喺Console Usage中檢查最終ShareAI扣款。上游成本字段同媒體字節唔會轉換成虛構嘅token數量。.

訪問同錯誤#

使用 inference 用於經批准嘅網絡成本推理或者 monetization_gateway 用於經批准嘅Builder加價同接受嘅計費條款。僅身份訪問唔授權支出。驗證、模型授權、點數不足、速率限制同執行失敗會返回結構化 error. 。喺超時或者提交不確定嘅情況下,檢查Usage或者視頻任務,然後先再創建另一個可能需要付費嘅請求。.

最後更新日期 2026 年 11 月 3 日

ShareAI平台文檔
所有文檔

按標題或者內容搜尋。

問下關於呢頁嘅問題

選擇一個助手嚟探索呢頁。你亦可以複製呢頁,然後貼喺你嘅對話入面。

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI