Logo

社交工作室

将高度风格化的创意效果和模板应用于时尚图片，用于社交媒体。

社交工作室

社交工作室端点将高度风格化、富有创意的美学模板应用于您的时尚图片，将其转化为引人注目的内容，非常适合社交媒体营销。

模型名称： social-studio

生命周期： stable

处理时间： ~15s–30s

输出格式： 自动 (JPEG 或 PNG)

交付方式： URL

积分： 每次生成 2 到 5 个（取决于质量）

请求

将您的图片和选定的样式 ID 提交到通用 /v1/run 端点：

POSThttps://fititon.app/api/v1/run

请求示例

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "social-studio",
           "inputs": {
             "personImage": "https://example.com/model-shot.jpg",
             "styleId": "action-figure",
             "quality": "2k",
             "sampleCount": 1
           }
         }'

响应

由于图片生成可能需要长达 30 秒，/v1/run 端点会立即返回 201 Created 状态以及一个异步作业 id。您必须使用此 id 轮询状态 API 以检索最终图片。或者，您可以配置 Webhook 以自动接收通知。请注意，我们的 Webhook 分发器强制执行严格的 15 秒超时。您的服务器必须在 15 秒内以 2xx 状态码确认 Webhook，否则我们将认为它失败并稍后重试。

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2024-03-10T12:00:00Z",
  "model_name": "social-studio"
}

当作业完成 (status: "success") 时，output 字段将包含一个结果 URL 数组：

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "success",
  "output": [
    "https://cdn.fititon.app/users/123/results/social-studio-123-0.png"
  ],
  "error": null,
  "created_at": "2024-03-10T12:00:00Z",
  "updated_at": "2024-03-10T12:00:20Z"
}

请求参数

必填参数

personImageRequiredstring

要风格化的源图片。可以是公开可访问的 URL 或 Base64 编码的图片字符串。

专业提示： 完整可见全身的照片能产生最佳的风格化效果。清晰的面部可见性很重要——AI 会利用面部特征来创建您的风格化版本。避免合影或部分被物体遮挡的图片。

格式要求 提交 Base64 字符串时，它必须包含标准的数据 URI 前缀（例如，data:image/jpeg;base64,...）。虽然 personImage 接受 Base64 字符串，但我们强烈建议对大于 3MB 的图片使用标准 HTTP URL，以避免在您的请求中达到全局 JSON 有效负载大小限制 (HTTP 413)。

styleIdRequiredstring

要应用于生成图片的摄影风格 ID。这决定了光照、美学和氛围。

可用样式：

Style NameStyle ID (`styleId`)

可选参数

quality'1k' | '2k' | '4k'

输出分辨率等级。 默认值：1k

sampleCountinteger

每次请求生成的图片变体数量。必须介于 1 到 4 之间。 默认值：1

ratiostring

宽高比覆盖。如果为空，系统默认为 1:1（适用于 Instagram/社交动态）。

支持的值： '1:1', '3:4', '4:3', '9:16', '16:9', '2:3', '3:2', '4:5', '5:4', '21:9'.

运行时错误

此功能的运行时错误使用 错误处理 中记录的共享集。如果在处理过程中发生错误，status 将更新为 "error"，并且 error 字段将包含具体的失败原因。

积分成本

对于开发者 API 请求，成本取决于所选的输出 quality 等级乘以 sampleCount。

公式： 成本 = 质量积分 × sampleCount

质量等级每张图片积分
1k (默认)2
2k3
4k5