图片生成 3D
图片生成 Q 版模型
通过上传图片和预配置的风格标签生成 Q 版 3D 角色模型。该操作消耗 30 点数。使用前需要先完成风格标签配置。
POST
/
api
/
createCuteModelsFromImages
curl --request POST \
--url https://alb.neural4d.com:3000/api/createCuteModelsFromImages \
--header 'Authorization: Bearer <token>' \
--form 'images=@/path/to/file' \
--form 'styleType=Pixel-Style'
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())
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);
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);
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());
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))
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
$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;
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());
{
"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"
}
授权
string
默认值:"Bearer ${YOUR_API_KEY}"
必填
使用 Neural4D 网站提供的 Bearer token。
请求体 multipart/form-data
string<binary>[]
必填
用于生成 Q 版模型的输入图片文件。数组长度:至少
1 个元素。string
必填
Q 版模型流程使用的已配置提示词标签。示例:
"Pixel-Style"。curl --request POST \
--url https://alb.neural4d.com:3000/api/createCuteModelsFromImages \
--header 'Authorization: Bearer <token>' \
--form 'images=@/path/to/file' \
--form 'styleType=Pixel-Style'
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())
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);
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);
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());
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))
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
$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;
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());
响应
- 200
批量创建结果
boolean
必填
批量请求是否处理成功。
integer
必填
上传的输入文件总数。
integer
必填
成功进入队列的输入文件数量。
integer
必填
未能进入队列的输入文件数量。
object[]
必填
object[]
必填
未能进入队列的输入文件对应的失败详情。
string
必填
批量操作的可读摘要信息。
{
"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"
}
⌘I
curl --request POST \
--url https://alb.neural4d.com:3000/api/createCuteModelsFromImages \
--header 'Authorization: Bearer <token>' \
--form 'images=@/path/to/file' \
--form 'styleType=Pixel-Style'
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())
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);
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);
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());
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))
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
$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;
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());
{
"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"
}

