black-forest-labs/flux-2-dev/image-to-image

图生图

在线试用获取 API 密钥OpenAPI llms.txt

提示词 *

Image URLs *

1 *

图片尺寸

更多设置（7 项）

生成加速

提示词扩展

Guidance Scale

Number of Images

推理步数

Output Format

随机种子

生成结果演示示例登录后试用

按用量计费 · 约 $0.024 / 张 · 每次冻结 $0.024

示例 · 由以下输入生成

Make it a snowy winter evening: add soft falling snow outside the glass and a string of small warm fairy lights around the sign. Keep the "NEW ARRIVALS" sign text, the books, the sleeping cat and the camera angle exactly the same.

价格

按实际用量计费，没有固定单价。

默认设置下通常约 $0.024 / 张。

每次请求会先临时冻结 $0.024，按实际用量扣费，通常在一分钟内完成：多余部分退回，超出部分从余额扣除，余额可能因此变为负数；余额为负时新请求暂停，充值后先抵扣欠款。

生成失败不收费。

API 接入

用这个模型 ID 提交生成请求。

POST/v1/model-tasks

black-forest-labs/flux-2-dev/image-to-image

请求体

{
  "model": "black-forest-labs/flux-2-dev/image-to-image",
  "input": {
    "prompt": "Make it a snowy winter evening: add soft falling snow outside the glass and a string of small warm fairy lights around the sign. Keep the \"NEW ARRIVALS\" sign text, the books, the sleeping cat and the camera angle exactly the same.",
    "acceleration": "regular",
    "enable_prompt_expansion": false,
    "guidance_scale": 2.5,
    "image_urls": [
      "https://pub-a7287c8d5de944d984e22a5bd3ab9bbe.r2.dev/uploads/capability-demo-4455cc52666e2731bd9f8edea86b75eb.png"
    ],
    "num_images": 1,
    "num_inference_steps": 28,
    "output_format": "png"
  }
}

输入 Schema

参数	类型	是否必填	默认值
image_urls	array	必填	—
prompt	string	必填	—
acceleration	string	可选	regular
enable_prompt_expansion	boolean	可选	false
guidance_scale	number	可选	2.5
image_size	object \| string	可选	—
num_images	integer	可选	1
num_inference_steps	integer	可选	28
output_format	string	可选	png
seed	integer	可选	—

返回结果

接口会返回生成结果，或返回可轮询的异步任务；具体响应方式与结果字段见下方示例和 Schema。

异步任务

提交响应

HTTP 202

/v1/model-tasksapplication/json

{
  "id": "task_example",
  "model": "black-forest-labs/flux-2-dev/image-to-image",
  "status": "queued"
}

状态响应

HTTP 200

/v1/model-tasks/{id}application/json

{
  "id": "task_example",
  "model": "black-forest-labs/flux-2-dev/image-to-image",
  "status": "completed",
  "output": {
    "images": [
      {
        "url": "https://api.musespan.com/v1/model-tasks/task_example/artifacts/0"
      }
    ]
  }
}

文件下载

HTTP 200

/v1/model-tasks/{id}/artifacts/{index}生成的图片（如 image/png）

任务完成后，output 里的文件地址就指向此接口，序号从 0 开始。下载时要带上同一个 API Key（Authorization 请求头）。

错误响应

HTTP 400

/v1/model-tasksapplication/json

{
  "error": {
    "code": "invalid_input",
    "message": "The input does not match this model's input schema. Check the model's API documentation.",
    "type": "invalid_request_error"
  }
}

调用示例

异步任务提交后返回任务 ID，轮询至 status 为 completed 后，按返回结果获取生成内容。API Key 在控制台获取。

# Use a new directory for each new generation. Rerunning here continues this task.
set -eu
test -s model-task-id.txt || python3 -c "import uuid; print(uuid.uuid4())" > model-task-id.txt
REQUEST_ID=$(cat model-task-id.txt)
# Idempotent: resending the same bytes with the same ID never charges twice.
curl --fail-with-body --retry 3 --retry-connrefused --request POST 'https://api.musespan.com/v1/model-tasks' \
  --header "Authorization: Bearer $MUSESPAN_API_KEY" \
  --header "X-Request-Id: $REQUEST_ID" \
  --header "Content-Type: application/json" \
  --data '{"model":"black-forest-labs/flux-2-dev/image-to-image","input":{"prompt":"Make it a snowy winter evening: add soft falling snow outside the glass and a string of small warm fairy lights around the sign. Keep the \"NEW ARRIVALS\" sign text, the books, the sleeping cat and the camera angle exactly the same.","acceleration":"regular","enable_prompt_expansion":false,"guidance_scale":2.5,"image_urls":["https://pub-a7287c8d5de944d984e22a5bd3ab9bbe.r2.dev/uploads/capability-demo-4455cc52666e2731bd9f8edea86b75eb.png"],"num_images":1,"num_inference_steps":28,"output_format":"png"}}'
# Poll every 5 seconds for up to 25 minutes until status is completed or failed.
# Still queued (with queue_position) 5 minutes after submission: failed with queue_timeout, not charged.
# No result 15 minutes after acceptance (or no confirmation 15 minutes after submission): failed with generation_timeout, not charged.
# Any failure is final: generate again in a new directory (a new X-Request-Id).
# A 404 means the POST did not arrive: rerun this script to resend it with the same ID.
curl --fail-with-body 'https://api.musespan.com/v1/model-tasks/'"$REQUEST_ID"'' --header "Authorization: Bearer $MUSESPAN_API_KEY"