> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neural4d.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 图片生成 Q 版模型

> 通过上传图片和预配置的风格标签生成 Q 版 3D 角色模型。该操作消耗 30 点数。使用前需要先完成风格标签配置。

## 授权

<ParamField header="Authorization" type="string" required default={'Bearer ${YOUR_API_KEY}'}>
  使用 Neural4D 网站提供的 Bearer token。
</ParamField>

## 请求体 <span className="api-content-type">multipart/form-data</span>

<ParamField body="images" type="string<binary>[]" required>
  用于生成 Q 版模型的输入图片文件。

  数组长度：至少 `1` 个元素。
</ParamField>

<ParamField body="styleType" type="string" required>
  Q 版模型流程使用的已配置提示词标签。

  示例：`"Pixel-Style"`。
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl --request POST \
    --url https://alb.neural4d.com:3000/api/createCuteModelsFromImages \
    --header 'Authorization: Bearer <token>' \
    --form 'images=@/path/to/file' \
    --form 'styleType=Pixel-Style'
  ```

  ```python Python theme={null}
  import requests

  response = requests.request(
      "POST",
      "https://alb.neural4d.com:3000/api/createCuteModelsFromImages",
      headers={
      "Authorization": "Bearer <token>",
      },
      files={"images": open('/path/to/file', 'rb')},
  )
  print(response.json())
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch("https://alb.neural4d.com:3000/api/createCuteModelsFromImages", {
    method: "POST",
    headers: {
      "Authorization": "Bearer <token>"
    },
    body: (() => { const form = new FormData(); form.append("file", fileInput.files[0]); return form; })(),
  });
  const data = await response.json();
  console.log(data);
  ```

  ```typescript TypeScript theme={null}
  const response: Response = await fetch("https://alb.neural4d.com:3000/api/createCuteModelsFromImages", {
    method: "POST",
    headers: {
      "Authorization": "Bearer <token>"
    },
    body: (() => { const form = new FormData(); form.append("file", fileInput.files[0]); return form; })(),
  });
  const data = await response.json();
  console.log(data);
  ```

  ```java Java theme={null}
  import java.net.URI;
  import java.net.http.*;

  HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://alb.neural4d.com:3000/api/createCuteModelsFromImages"))
      .header("Authorization", "Bearer <token>")
      .method("POST", HttpRequest.BodyPublishers.noBody())
      .build();
  HttpResponse<String> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
  System.out.println(response.body());
  ```

  ```go Go theme={null}
  package main

  import (
    "fmt"
    "io"
    "net/http"
    "strings"
  )

  payload := nil
  req, _ := http.NewRequest("POST", "https://alb.neural4d.com:3000/api/createCuteModelsFromImages", payload)
  req.Header.Set("Authorization", "Bearer <token>")
  resp, _ := http.DefaultClient.Do(req)
  defer resp.Body.Close()
  bodyBytes, _ := io.ReadAll(resp.Body)
  fmt.Println(string(bodyBytes))
  ```

  ```ruby Ruby theme={null}
  require "net/http"
  require "json"

  uri = URI("https://alb.neural4d.com:3000/api/createCuteModelsFromImages")
  request = Net::HTTP::Post.new(uri)
  request["Authorization"] = "Bearer <token>"

  response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") { |http| http.request(request) }
  puts response.body
  ```

  ```php PHP theme={null}
  <?php

  $ch = curl_init("https://alb.neural4d.com:3000/api/createCuteModelsFromImages");
  curl_setopt_array($ch, [
      CURLOPT_CUSTOMREQUEST => "POST",
      CURLOPT_RETURNTRANSFER => true,
      CURLOPT_HTTPHEADER => ["Authorization: Bearer <token>"],
  ]);
  $response = curl_exec($ch);
  curl_close($ch);
  echo $response;
  ```

  ```csharp C# theme={null}
  using System.Net.Http;
  using System.Text;

  using var client = new HttpClient();
  using var request = new HttpRequestMessage(HttpMethod.Post, "https://alb.neural4d.com:3000/api/createCuteModelsFromImages");
  request.Headers.TryAddWithoutValidation("Authorization", "Bearer <token>");
  using var response = await client.SendAsync(request);
  Console.WriteLine(await response.Content.ReadAsStringAsync());
  ```
</RequestExample>

## 响应

<Tabs sync={false}>
  <Tab title="200">
    批量创建结果

    <ResponseField name="success" type="boolean" required>
      批量请求是否处理成功。
    </ResponseField>

    <ResponseField name="totalFiles" type="integer" required>
      上传的输入文件总数。
    </ResponseField>

    <ResponseField name="successCount" type="integer" required>
      成功进入队列的输入文件数量。
    </ResponseField>

    <ResponseField name="failureCount" type="integer" required>
      未能进入队列的输入文件数量。
    </ResponseField>

    <ResponseField name="results" type="object[]" required>
      每个成功处理的输入文件对应的入队结果。

      <Expandable title="child attributes">
        <ResponseField name="uuids" pre={["results[]."]} type="string[]" required>
          此输入文件生成的任务或模型 UUID 列表。
        </ResponseField>

        <ResponseField name="success" pre={["results[]."]} type="boolean" required>
          此输入文件是否成功进入队列。
        </ResponseField>

        <ResponseField name="message" pre={["results[]."]} type="string" required>
          此输入文件对应的可读处理结果。
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="failures" type="object[]" required>
      未能进入队列的输入文件对应的失败详情。
    </ResponseField>

    <ResponseField name="message" type="string" required>
      批量操作的可读摘要信息。
    </ResponseField>
  </Tab>
</Tabs>

<ResponseExample>
  ```json 200 success theme={null}
  {
    "success": true,
    "totalFiles": 1,
    "successCount": 1,
    "failureCount": 0,
    "results": [
      {
        "uuids": [
          "31f15c88-48ae"
        ],
        "success": true,
        "message": "Task created and model generation started, please retrieve model after a moment"
      }
    ],
    "failures": [],
    "message": "Processed 1 files: 1 succeeded, 0 failed"
  }
  ```
</ResponseExample>
