# 二次元v5（福瑞） Uncensored API 文档

所有注册用户可使用，使用独立 API 价格与积分余额，不享受网站会员折扣。API Key 接入不受网页会员等级的任务并发上限限制，有效密钥调用不设请求频率上限。支持文生图、部分图片模型的图生图、文生视频和参考图生视频；部分视频模型支持参考视频、参考音频与视频编辑，具体以各模型文档为准；回调暂未开放。视频接口为 /api/v1/videos/generations 和 /api/v1/videos/quote，结果位于 task.videos[].url。

## 鉴权

在开发者控制台创建密钥，请求头为 Authorization: Bearer YOUR_API_KEY。仅在自己的服务端使用密钥。

## 模型参数

模型 ID：anime-v5-furry
默认配置参考价格：0.04 积分
比例：1:1 / 9:16 / 16:9 / 3:4 / 4:3 / 2:3 / 3:2 / 4:5 / 5:4 / 1:2 / 2:1 / 9:21 / 21:9 / 1:3 / 3:1
尺寸：
质量：由模型默认配置决定

## 提交生图

POST https://luocisheng.cn/api/v1/images/generations
Content-Type: application/json
Idempotency-Key: image-demo-0001

```json
{
  "modelId": "anime-v5-furry",
  "prompt": "一只坐在窗边的猫，柔和的自然光",
  "numImages": 1,
  "aspectRatio": "2:3"
}
```

成功返回 HTTP 202 和 taskId。提交时冻结积分，结束后结算。

## OpenAI 兼容文生图

Base URL：https://luocisheng.cn/api/v1。仍使用本站 API Key 和 API 钱包。向同一个 images/generations 地址发送 `model`（本站模型 ID）、`prompt` 和可选 `n`，最多等待生成结算 120 秒，成功返回 HTTP 200 和 `data[].b64_json`。选填 `response_format: "url"` 时返回本站下载地址，下载仍需 Bearer 鉴权。不传 `size` 或传 `auto` 使用模型默认值；`1024x1024`、`1536x1024`、`1024x1536`、`1792x1024`、`1024x1792` 映射为对应画幅和 1K 档，实际像素由模型决定。图片编辑使用 POST /api/v1/images/edits，以 multipart/form-data 提交同样的模型和提示词，使用 image 或 image[] 上传 PNG、JPEG、WebP 参考图，单张最多 5 MiB，最多 4 张且受模型限制。暂不支持遮罩或远程文件。生成与编辑可传 stream=true（n=1、partial_images=0），仅在结算后发送最终 SSE 事件，不发送过程预览。关闭客户端自动重试；提交时带 `Idempotency-Key`，超时后查询返回的 `task_id`，或复用原键和原请求。

## API 余额

GET https://luocisheng.cn/api/v1/balance 返回 balance、held、available，单位为 API 积分。API 与网站积分互不通用，API 从零开始，需在开发者控制台单独充值。

## 详细价格表

二次元v5（福瑞） Uncensored API 调用价格

| API 积分 / 次 | 约合人民币 / 次 |
| --- | --- |
| 0.04 | ¥0.2760 |

1 美元 = 1 API 积分。表内为当前 API 售价；人民币仅为汇率换算参考，不改变美元积分扣费。实际以提交前报价及任务结算为准。

表内按 numImages = 1 计费，多份输出按请求数量计算；固定多图模型按一次生成计费，不按返回图片张数重复收费。

参考图片无额外附加费；图片编辑如有独立档位，按表中对应价格计费。

支持高清模式时，高清与普通模式同价。

本站固定汇率：1 美元 = 6.9 元。


## 官方画师串与负面预设 ID

以下列表每次读取文档时从当前配置生成，管理员增删后重新获取即可同步。把所选 ID 放入 officialPresetIds，服务端自动拼接并保留自填正负提示词。

### 二次元v5（福瑞） Uncensored

#### 画师串

- 奶油肤质：`official:55bf1e69-44a2-43a4-8a95-8f75aa98c187`
- 二次元肉感：`official:b4faac9e-4dc6-4f2f-ae29-867445d13390`
- 精致二次元：`official:84e93906-e260-4055-a70d-cb54a89a4584`
- 平涂二次元：`official:12c7662f-80bb-4681-9f0c-becf158f74ef`

#### 负面预设

- 奶油肤质负面：`official:e632160f-79f7-40ca-9ebb-37b4150b81da`
- 平涂二次元负面：`official:f696fde7-be8f-4194-93c4-b2424c1e1b42`

请求示例：

```json
{
  "modelId": "anime-v5-furry",
  "prompt": "一位站在花园中的角色",
  "officialPresetIds": [
    "official:55bf1e69-44a2-43a4-8a95-8f75aa98c187",
    "official:e632160f-79f7-40ca-9ebb-37b4150b81da"
  ]
}
```


## 洛辞官方预设

生成和报价传入 `officialPresetIds: ["official:预设ID"]`，按数组顺序组合指定的官方画师串与负面预设，并保留自填正负提示词。不传或空数组不启用，不读取网页个人开关。GET /api/v1/models 的 officialPresets 返回当前可用的 id、name、type（artist/negative），仅可选择适用于当前模型和访问权限的预设。OpenAI 兼容生成支持同名数组参数，multipart 编辑传 JSON 数组文本。预设在任务创建时固定。


## 多角色提示词

最多 22 个角色；每个角色 prompt 必填且不超过 8000 字符，negativePrompt 可选且不超过 8000 字符。x、y 为 0–1 的数字，默认 0.5。useCoords 默认 false（自动定位），true 启用指定位置；useOrder 默认 true。生成与报价均支持；角色参数参与任务快照和幂等校验。仅使用 modelId 的本站 JSON 接口支持这些参数。

```json
{
  "modelId": "anime-v5-furry",
  "prompt": "两位角色站在花园中",
  "imageAdvanced": {
    "useCoords": true,
    "useOrder": true,
    "characters": [
      {
        "prompt": "女孩，红色长发",
        "negativePrompt": "帽子",
        "x": 0.25,
        "y": 0.5
      },
      {
        "prompt": "男孩，蓝色短发",
        "x": 0.75,
        "y": 0.5
      }
    ]
  }
}
```


## 图像清晰度

imageSize 不传时默认使用该模型支持的最高 K 档，按对应尺寸售价计费；显式传入时使用指定档位。

## 报价

POST https://luocisheng.cn/api/v1/images/quote，参数与生成接口相同。estimatedPoints 是报价积分。

## 查询与下载

GET https://luocisheng.cn/api/v1/tasks/{taskId}
每 3–5 秒查询一次；task.images[].url 是本站相对图片地址，下载同样需要鉴权请求头。
settled 为 true 时 chargedPoints 是实际扣费；未结算时为 null。状态包括 queued、processing、succeeded、partial、failed。

## 重试与错误

网络超时复用同一 Idempotency-Key 和相同参数，避免重复创建任务或冻结积分。幂等键为 8–128 位字母、数字或 ._:-。修改参数返回 409；删除任务后原键不再提供防重保证。
有效 API Key 的模型查询、报价、提交、任务查询和下载不设请求频率上限。无效密钥的重复认证尝试仍有防滥用保护。
错误格式为 {"error":"错误说明","code":"ERROR_CODE"}。400 参数无效，401 密钥无效，402 积分不足，404 资源不可访问，409 幂等冲突，429 无效密钥认证尝试过于频繁，5xx 服务暂不可用。