Edge inference package (ADR 0072) — openpi_client + embodiment fail-closed.
POST
/v1/model-versions/{modelVersionId}/edge-inference-packagecurl -X POST 'https://api.embodiflow.io/v1/model-versions/{modelVersionId}/edge-inference-package' \
-H 'Authorization: Bearer $EMBODIFLOW_PAT' \
-H 'Content-Type: application/json' \
-d '{
"embodimentProfileId": "00000000-0000-0000-0000-000000000000",
"mode": "local",
"strategyKey": "string",
"remotePolicyHost": "string",
"remotePolicyPort": 0,
"steps": 0,
"targetArch": "x86-cuda",
"wireProtocols": "openpi-ws",
"useFakeTransport": true
}'认证
每个请求都需要携带个人访问令牌（PAT）。
- Authorization: Bearer PAT
路径参数
- modelVersionIdstring必填
请求头参数
- Idempotency-Keystring
Optional idempotency key, at most 255 characters (UUIDv4 recommended). A repeated key returns the first response byte-for-byte, including a 5xx. The same key with a different body, or a second in-flight request, returns 409 IDEMPOTENCY_CONFLICT. Keys are unique per tenant and retained for 24 hours.
请求体
Content-Typeapplication/json
- embodimentProfileIdstring (uuid)必填
- modestring必填可选值localremote_ws
- strategyKeystring
- remotePolicyHoststring
- remotePolicyPortnumber
- stepsnumber
- targetArchstring
Image line (ADR 0145 §6). Jetson is a separate line, not a platform.
可选值x86-cudajetson-jp6cpu - wireProtocolsarray<string>
Non-empty subset when provided; defaults to `openpi-ws` only.
- useFakeTransportboolean
响应
Success
- dataobject必填
- schemaVersionstring必填可选值embodiflow-edge-inference-package/v1
- modelVersionIdstring必填
- tenantIdstring必填
- projectIdstring必填
- embodimentProfileIdstring必填
- embodimentCodestring必填
- modestring必填可选值localremote_ws
- weightUrlsarray<string>必填
- runtimeImagestring | null必填
- edgeConfigobject必填
- runCommandstring必填
- docLinksobject必填
- generatedAtstring必填
- expiresAtstring必填
- targetArchstring必填可选值x86-cudajetson-jp6cpu
- wiresarray<EdgeWireEndpointDto>必填
- hostRequirementsobject必填
- bundlePullobject必填
- securityNoticestring | null必填
响应示例
{
"data": {
"schemaVersion": "embodiflow-edge-inference-package/v1",
"modelVersionId": "string",
"tenantId": "string",
"projectId": "string",
"embodimentProfileId": "string",
"embodimentCode": "string",
"mode": "local",
"weightUrls": [
"string"
],
"runtimeImage": "string",
"edgeConfig": {},
"runCommand": "string",
"docLinks": {},
"generatedAt": "string",
"expiresAt": "string",
"targetArch": "x86-cuda",
"wires": [
{
"protocol": "openpi-ws",
"port": 0,
"plaintext": false
}
],
"hostRequirements": {
"targetArch": "x86-cuda",
"gpuRuntime": "string",
"dockerGpuFlag": "string",
"minGpuMemoryGb": 0,
"notes": [
"string"
]
},
"bundlePull": {
"bundleObjectPrefix": "string",
"downloadSessionId": "string",
"sessionToken": "string",
"expiresAt": "string",
"presignedUrls": [
"string"
]
},
"securityNotice": "string"
}
}服务器https://api.embodiflow.io/v1https://api.embodiflow.dev/v1