@byte_fluffy/nexra-sdk 0.1.0-alpha.4 → 0.1.0-alpha.6

package/dist/{index-mytCeh5t.d.ts → index-FyUOK0F-.d.ts}

@@ -302,6 +302,37 @@ declare function jsonBody(value: unknown): Pick<RequestInit, "body" | "headers">
 declare function queryString(values: Record<string, string | number | undefined>): string;
 declare function sleep(milliseconds: number, signal?: AbortSignal | null): Promise<void>;
 
+/** Unified canvas vocabulary: resolution 1K/2K/4K, ratio X:X. */
+type UnifiedMediaGeometry = {
+    resolution?: string;
+    ratio?: string;
+    quality?: string;
+};
+type MediaGeometryField = {
+    field: string;
+    nest?: string;
+    options: readonly string[];
+    default?: string;
+    optionLabels: Readonly<Record<string, string>>;
+};
+type MediaGeometryProjection = {
+    kind: "pixel-size" | "tier-size" | "resolution-ratio" | "ratio-only" | "none";
+    resolution?: MediaGeometryField;
+    ratio?: MediaGeometryField;
+    quality?: MediaGeometryField;
+};
+/** Schema → unified resolution/ratio/quality controls for app UIs. */
+declare function projectMediaGeometry(inputSchema: JsonObject): MediaGeometryProjection;
+/** Unified geometry → the model's native catalog fields (channel original params). */
+declare function encodeMediaGeometry(inputSchema: JsonObject, geometry: UnifiedMediaGeometry): JsonObject;
+/** Native catalog fields → unified resolution/ratio/quality. */
+declare function decodeMediaGeometry(inputSchema: JsonObject, nativeInput: JsonObject): UnifiedMediaGeometry;
+/**
+ * Rewrite a Task/quote body: unified keys become native catalog fields.
+ * Native size/ratio already present is left alone (existing callers keep working).
+ */
+declare function applyMediaGeometry(inputSchema: JsonObject, input: JsonObject): JsonObject;
+
 declare class CatalogClient {
     private readonly transport;
     constructor(transport: HttpTransport);
@@ -310,4 +341,4 @@ declare class CatalogClient {
 declare function getModelSpec(modelId: string): NexraModelSpec | undefined;
 declare function listModelSpecs(filter?: NexraModelSpecFilter): readonly NexraModelSpec[];
 
-export { type NormalizedUsageV1 as A, type BillingMetric as B, type CursorPage as C, type PriceEvaluationIssue as D, type PriceEvaluationLine as E, type FetchLike as F, type PriceRule as G, HttpTransport as H, type UsageEvidenceAssessment as I, type JsonObject as J, type UsageEvidenceStatus as K, allocateDiscountedPriceLines as L, type ModelSearchParams as M, type NexraSettlement as N, assessUsageEvidence as O, type PriceEvaluation as P, evaluatePriceRule as Q, getModelSpec as R, jsonBody as S, type TaskModelSummary as T, type UsageComponentEvidence as U, listModelSpecs as V, queryString as W, sleep as X, validateMeteringContract as Y, validateNormalizedUsage as Z, validatePriceRule as _, type JsonValue as a, type TaskModel as b, type ModelSchema as c, CatalogClient as d, type NexraClientOptions as e, BILLING_EXPORT_DIMENSIONS as f, BILLING_METRICS as g, type CreateNexraQuoteRequest as h, type JsonPrimitive as i, type MeteredPriceRate as j, type MeteredPriceRuleV1 as k, type MeteredUsageComponent as l, type MeteringContract as m, type MeteringKind as n, type ModelCapabilitySummary as o, type ModelDateVersion as p, type ModelEndpointSummary as q, type ModelModality as r, type ModelResourceList as s, type ModelResourceOption as t, type NexraBillingCurrency as u, type NexraModelOperation as v, type NexraModelSpec as w, type NexraModelSpecFilter as x, type NexraQuote as y, type NexraSalePrice as z };
+export { listModelSpecs as $, type NexraQuote as A, type BillingMetric as B, type CursorPage as C, type NexraSalePrice as D, type NormalizedUsageV1 as E, type FetchLike as F, type PriceEvaluationIssue as G, HttpTransport as H, type PriceEvaluationLine as I, type JsonObject as J, type PriceRule as K, type UsageComponentEvidence as L, type ModelSchema as M, type NexraSettlement as N, type UsageEvidenceAssessment as O, type PriceEvaluation as P, type UsageEvidenceStatus as Q, allocateDiscountedPriceLines as R, applyMediaGeometry as S, type TaskModelSummary as T, type UnifiedMediaGeometry as U, assessUsageEvidence as V, decodeMediaGeometry as W, encodeMediaGeometry as X, evaluatePriceRule as Y, getModelSpec as Z, jsonBody as _, type JsonValue as a, projectMediaGeometry as a0, queryString as a1, sleep as a2, validateMeteringContract as a3, validateNormalizedUsage as a4, validatePriceRule as a5, type ModelSearchParams as b, type TaskModel as c, CatalogClient as d, type NexraClientOptions as e, BILLING_EXPORT_DIMENSIONS as f, BILLING_METRICS as g, type CreateNexraQuoteRequest as h, type JsonPrimitive as i, type MediaGeometryField as j, type MediaGeometryProjection as k, type MeteredPriceRate as l, type MeteredPriceRuleV1 as m, type MeteredUsageComponent as n, type MeteringContract as o, type MeteringKind as p, type ModelCapabilitySummary as q, type ModelDateVersion as r, type ModelEndpointSummary as s, type ModelModality as t, type ModelResourceList as u, type ModelResourceOption as v, type NexraBillingCurrency as w, type NexraModelOperation as x, type NexraModelSpec as y, type NexraModelSpecFilter as z };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { J as JsonObject, B as BillingMetric, a as JsonValue, N as NexraSettlement, C as CursorPage, H as HttpTransport, M as ModelSearchParams, T as TaskModelSummary, b as TaskModel, c as ModelSchema, d as CatalogClient, e as NexraClientOptions } from './index-mytCeh5t.js';
-export { f as BILLING_EXPORT_DIMENSIONS, g as BILLING_METRICS, h as CreateNexraQuoteRequest, F as FetchLike, i as JsonPrimitive, j as MeteredPriceRate, k as MeteredPriceRuleV1, l as MeteredUsageComponent, m as MeteringContract, n as MeteringKind, o as ModelCapabilitySummary, p as ModelDateVersion, q as ModelEndpointSummary, r as ModelModality, s as ModelResourceList, t as ModelResourceOption, u as NexraBillingCurrency, v as NexraModelOperation, w as NexraModelSpec, x as NexraModelSpecFilter, y as NexraQuote, z as NexraSalePrice, A as NormalizedUsageV1, P as PriceEvaluation, D as PriceEvaluationIssue, E as PriceEvaluationLine, G as PriceRule, U as UsageComponentEvidence, I as UsageEvidenceAssessment, K as UsageEvidenceStatus, L as allocateDiscountedPriceLines, O as assessUsageEvidence, Q as evaluatePriceRule, R as getModelSpec, S as jsonBody, V as listModelSpecs, W as queryString, X as sleep, Y as validateMeteringContract, Z as validateNormalizedUsage, _ as validatePriceRule } from './index-mytCeh5t.js';
+import { J as JsonObject, B as BillingMetric, a as JsonValue, N as NexraSettlement, C as CursorPage, M as ModelSchema, T as TaskModelSummary, H as HttpTransport, b as ModelSearchParams, c as TaskModel, d as CatalogClient, e as NexraClientOptions } from './index-FyUOK0F-.js';
+export { f as BILLING_EXPORT_DIMENSIONS, g as BILLING_METRICS, h as CreateNexraQuoteRequest, F as FetchLike, i as JsonPrimitive, j as MediaGeometryField, k as MediaGeometryProjection, l as MeteredPriceRate, m as MeteredPriceRuleV1, n as MeteredUsageComponent, o as MeteringContract, p as MeteringKind, q as ModelCapabilitySummary, r as ModelDateVersion, s as ModelEndpointSummary, t as ModelModality, u as ModelResourceList, v as ModelResourceOption, w as NexraBillingCurrency, x as NexraModelOperation, y as NexraModelSpec, z as NexraModelSpecFilter, A as NexraQuote, D as NexraSalePrice, E as NormalizedUsageV1, P as PriceEvaluation, G as PriceEvaluationIssue, I as PriceEvaluationLine, K as PriceRule, U as UnifiedMediaGeometry, L as UsageComponentEvidence, O as UsageEvidenceAssessment, Q as UsageEvidenceStatus, R as allocateDiscountedPriceLines, S as applyMediaGeometry, V as assessUsageEvidence, W as decodeMediaGeometry, X as encodeMediaGeometry, Y as evaluatePriceRule, Z as getModelSpec, _ as jsonBody, $ as listModelSpecs, a0 as projectMediaGeometry, a1 as queryString, a2 as sleep, a3 as validateMeteringContract, a4 as validateNormalizedUsage, a5 as validatePriceRule } from './index-FyUOK0F-.js';
 export { ceilDecimal, multiplyDecimal } from './decimal.js';
 
 declare const MEDIA_KINDS: readonly ["image", "video", "audio", "document", "archive", "other"];
@@ -647,6 +647,8 @@ interface RequestDetails {
     model: string | null;
     operation: string | null;
     status: string;
+    /** Linked Task lifecycle when this request accepted a Task; HTTP `status` stays accepted. */
+    taskStatus?: string | null;
     httpStatus: number | null;
     errorCode: string | null;
     /** HTTP duration, never substituted with asynchronous task duration. */
@@ -664,6 +666,10 @@ interface RequestDetails {
     startedAt?: string;
     completedAt?: string;
     input: JsonObject | null;
+    /** Present only on single-request reads (`includeOutput`). */
+    output?: JsonValue | null;
+    /** Output media with durable TOS URLs; present only on `includeOutput`. */
+    assets?: MediaAsset[];
     receivedAt: string;
     finishedAt: string | null;
 }
@@ -718,6 +724,8 @@ interface TaskRun<TOutput = JsonValue> {
     updatedAt: string;
 }
 interface CreateTaskRunRequest<TInput = Record<string, unknown>> {
+    /** Versioned experience-center canonical input. Omitted means native shared input. */
+    inputFormat?: "sandbox-v1";
     submittedAt?: string;
     models: string[];
     repetitions?: number;
@@ -906,6 +914,88 @@ declare function availabilityBuckets(items: readonly AvailabilityObservation[],
 declare function rateProbeUsage(price: unknown, usage: JsonObject | undefined): string | undefined;
 declare function probeCostExceeds(actual: string, limit: string): boolean;
 
+declare const SANDBOX_OPERATIONS: readonly [{
+    readonly id: "text-to-speech";
+    readonly modality: "audio";
+    readonly label: "语音合成";
+}, {
+    readonly id: "text-to-music";
+    readonly modality: "audio";
+    readonly label: "音乐生成";
+}, {
+    readonly id: "multimodal-to-video";
+    readonly modality: "video";
+    readonly label: "全能参考生";
+}, {
+    readonly id: "text-to-video";
+    readonly modality: "video";
+    readonly label: "参考生成视频";
+}, {
+    readonly id: "image-to-video";
+    readonly modality: "video";
+    readonly label: "首尾帧生成视频";
+}, {
+    readonly id: "text-to-image";
+    readonly modality: "image";
+    readonly label: "文生图";
+}, {
+    readonly id: "image-to-image";
+    readonly modality: "image";
+    readonly label: "图生图";
+}, {
+    readonly id: "text-to-text";
+    readonly modality: "language";
+    readonly label: "对话生成";
+}];
+type SandboxOperation = typeof SANDBOX_OPERATIONS[number]['id'];
+declare const sandboxObject: (v: unknown) => JsonObject;
+/** Catalog aliases are separate routes, not additional comparison models. */
+declare function sandboxIdentity(slug: string): string;
+declare function sandboxModelModes(model: Pick<TaskModelSummary, 'slug' | 'modality' | 'capabilities'>): string[];
+declare function sandboxOperations(models: TaskModelSummary[]): ({
+    readonly id: "text-to-speech";
+    readonly modality: "audio";
+    readonly label: "语音合成";
+} | {
+    readonly id: "text-to-music";
+    readonly modality: "audio";
+    readonly label: "音乐生成";
+} | {
+    readonly id: "multimodal-to-video";
+    readonly modality: "video";
+    readonly label: "全能参考生";
+} | {
+    readonly id: "text-to-video";
+    readonly modality: "video";
+    readonly label: "参考生成视频";
+} | {
+    readonly id: "image-to-video";
+    readonly modality: "video";
+    readonly label: "首尾帧生成视频";
+} | {
+    readonly id: "text-to-image";
+    readonly modality: "image";
+    readonly label: "文生图";
+} | {
+    readonly id: "image-to-image";
+    readonly modality: "image";
+    readonly label: "图生图";
+} | {
+    readonly id: "text-to-text";
+    readonly modality: "language";
+    readonly label: "对话生成";
+})[];
+declare function sandboxProperties(schema: ModelSchema): {
+    root: JsonObject;
+    parameters: JsonObject;
+};
+declare function sandboxSupports(schema: ModelSchema, feature: string): boolean;
+declare function sandboxVoiceKey(model: string): string;
+/** Canonical inputs are opt-in; ordinary API calls and detail Playgrounds retain native schemas. */
+declare function adaptSandboxInput(schema: ModelSchema, mode: string, input: JsonObject): JsonObject;
+/** Minimal operation form. Unsupported controls remain explicit provider defaults. */
+declare function sandboxInputSchema(schemas: ModelSchema[], mode: string): ModelSchema;
+
 declare class AssetsClient {
     private readonly transport;
     constructor(transport: HttpTransport);
@@ -1003,4 +1093,4 @@ interface VerifyWebhookOptions {
 /** @deprecated Only verifies legacy signed webhooks, not callback_url notifications. */
 declare function verifyWebhook(request: Request, secret: string, options?: VerifyWebhookOptions): Promise<boolean>;
 
-export { ADMIN_USER_ACTIVITY_KINDS, ADMIN_USER_ROLES, ADMIN_USER_STATUSES, type AdminOverview, type AdminUserActivityKind, type AdminUserActivityPage, type AdminUserActivityRow, type AdminUserApiKeyUpdate, type AdminUserApiKeyUpdateResult, type AdminUserDetail, type AdminUserDiscountRow, type AdminUserKeyRow, type AdminUserListCursor, type AdminUserListPage, type AdminUserListQuery, type AdminUserPricingAdjustmentRow, type AdminUserRole, type AdminUserStatus, type AdminUserSummaryRow, type AdminUserUpdate, type AdminUserUpdateResult, type AdminUserWalletOpenInput, type AdminUserWalletOpenResult, type AdminUserWalletSummary, type AdminWalletRechargeInput, type AdminWalletRechargeResult, type ApiErrorPayload, type AssetImportRequest, type AssetInput, type AssetReference, type AssetUploadOptions, AssetsClient, type AvailabilityBucket, type AvailabilityObservation, type AvailabilityStats, BILLING_CURRENCY, BillingMetric, CatalogClient, type CreateTaskOptions, type CreateTaskRequest, type CreateTaskRunRequest, CursorPage, HttpTransport, JsonObject, JsonValue, MEDIA_KINDS, MONEY_STRING_PATTERN, type MediaAsset, type MediaAssetStatus, type MediaKind, ModelSchema, ModelSearchParams, ModelsClient, type MoneyString, NexraApiError, NexraClient, NexraClientOptions, NexraSettlement, NexraTaskError, NexraWaitTimeoutError, type ObservationResult, type ProbeRunView, type ProbeTargetConfig, type ProbeTargetView, type RequestDetails, type RunResult, type RunTaskOptions, TASK_STATUSES, TOKEN_METRICS, type Task, type TaskCost, type TaskError, type TaskEvent, type TaskEventType, type TaskListParams, TaskModel, TaskModelSummary, type TaskPage, type TaskProgress, type TaskReceipt, type TaskResult, type TaskRun, type TaskRunListParams, type TaskStatus, type TaskTiming, type TaskUsage, type TaskWebhookConfig, TasksClient, type TerminalTaskStatus, USAGE_AMOUNT_KINDS, USAGE_ANOMALY_CATEGORIES, USAGE_FILTER_KINDS, USAGE_FILTER_SELECTION_LIMIT, USAGE_GROUP_BYS, USAGE_NORMALIZATION_STATUSES, USAGE_RATING_STATUSES, USAGE_SOURCES, type UploadDeliveryRegion, type UsageAmountKind, type UsageAnomaliesPage, type UsageAnomaliesQuery, type UsageAnomalyBreakdownRow, type UsageAnomalyCategory, type UsageAnomalyRow, type UsageAnomalySummaryPage, type UsageAnomalySummaryQuery, type UsageAnomalySummaryRow, type UsageDetailCharge, type UsageDetailRow, type UsageDetailUsage, type UsageDetailsPage, type UsageDetailsQuery, type UsageFilterKind, type UsageFilterOption, type UsageFilterOptionsPage, type UsageFilterOptionsQuery, type UsageFilters, type UsageGroupBy, type UsageNormalizationStatus, type UsageRatingStatus, type UsageSource, type UsageSummaryAmount, type UsageSummaryGroup, type UsageSummaryPage, type UsageSummaryQuery, type UsageSummaryRow, type UsageTimeWindow, type VerifyWebhookOptions, WALLET_MAX_BALANCE_UNITS, type WaitTaskOptions, type WatchTaskOptions, availabilityBuckets, availabilityStats, classifyObservation, createNexra, defaultProbeInterval, defaultProbeTimeout, encodeAdminUserCursor, encodeUsageFilterCursor, encodeUsageKeysetCursor, encodeUsageSummaryCursor, isMoneyString, isTerminalTaskStatus, modelInputDefaults, modelInputUi, modelUploadRegion, moneyFromUnits, moneyToUnits, multiplyMoney, normalizeModelParameterSchema, orderedSchemaProperties, parseAdminUserCursor, parseUsageFilterCursor, parseUsageKeysetCursor, parseUsageSummaryCursor, probeCostExceeds, rateProbeUsage, taskReceipt, taskResult, uploadedMediaInput, uploadedMediaUrl, validateAdminUserApiKeyUpdate, validateAdminUserListQuery, validateAdminUserUpdate, validateAdminWalletRechargeInput, validateUsageAnomaliesQuery, validateUsageAnomalySummaryQuery, validateUsageDetailsQuery, validateUsageFilterOptionsQuery, validateUsageFilters, validateUsageSummaryQuery, verifyWebhook };
+export { ADMIN_USER_ACTIVITY_KINDS, ADMIN_USER_ROLES, ADMIN_USER_STATUSES, type AdminOverview, type AdminUserActivityKind, type AdminUserActivityPage, type AdminUserActivityRow, type AdminUserApiKeyUpdate, type AdminUserApiKeyUpdateResult, type AdminUserDetail, type AdminUserDiscountRow, type AdminUserKeyRow, type AdminUserListCursor, type AdminUserListPage, type AdminUserListQuery, type AdminUserPricingAdjustmentRow, type AdminUserRole, type AdminUserStatus, type AdminUserSummaryRow, type AdminUserUpdate, type AdminUserUpdateResult, type AdminUserWalletOpenInput, type AdminUserWalletOpenResult, type AdminUserWalletSummary, type AdminWalletRechargeInput, type AdminWalletRechargeResult, type ApiErrorPayload, type AssetImportRequest, type AssetInput, type AssetReference, type AssetUploadOptions, AssetsClient, type AvailabilityBucket, type AvailabilityObservation, type AvailabilityStats, BILLING_CURRENCY, BillingMetric, CatalogClient, type CreateTaskOptions, type CreateTaskRequest, type CreateTaskRunRequest, CursorPage, HttpTransport, JsonObject, JsonValue, MEDIA_KINDS, MONEY_STRING_PATTERN, type MediaAsset, type MediaAssetStatus, type MediaKind, ModelSchema, ModelSearchParams, ModelsClient, type MoneyString, NexraApiError, NexraClient, NexraClientOptions, NexraSettlement, NexraTaskError, NexraWaitTimeoutError, type ObservationResult, type ProbeRunView, type ProbeTargetConfig, type ProbeTargetView, type RequestDetails, type RunResult, type RunTaskOptions, SANDBOX_OPERATIONS, type SandboxOperation, TASK_STATUSES, TOKEN_METRICS, type Task, type TaskCost, type TaskError, type TaskEvent, type TaskEventType, type TaskListParams, TaskModel, TaskModelSummary, type TaskPage, type TaskProgress, type TaskReceipt, type TaskResult, type TaskRun, type TaskRunListParams, type TaskStatus, type TaskTiming, type TaskUsage, type TaskWebhookConfig, TasksClient, type TerminalTaskStatus, USAGE_AMOUNT_KINDS, USAGE_ANOMALY_CATEGORIES, USAGE_FILTER_KINDS, USAGE_FILTER_SELECTION_LIMIT, USAGE_GROUP_BYS, USAGE_NORMALIZATION_STATUSES, USAGE_RATING_STATUSES, USAGE_SOURCES, type UploadDeliveryRegion, type UsageAmountKind, type UsageAnomaliesPage, type UsageAnomaliesQuery, type UsageAnomalyBreakdownRow, type UsageAnomalyCategory, type UsageAnomalyRow, type UsageAnomalySummaryPage, type UsageAnomalySummaryQuery, type UsageAnomalySummaryRow, type UsageDetailCharge, type UsageDetailRow, type UsageDetailUsage, type UsageDetailsPage, type UsageDetailsQuery, type UsageFilterKind, type UsageFilterOption, type UsageFilterOptionsPage, type UsageFilterOptionsQuery, type UsageFilters, type UsageGroupBy, type UsageNormalizationStatus, type UsageRatingStatus, type UsageSource, type UsageSummaryAmount, type UsageSummaryGroup, type UsageSummaryPage, type UsageSummaryQuery, type UsageSummaryRow, type UsageTimeWindow, type VerifyWebhookOptions, WALLET_MAX_BALANCE_UNITS, type WaitTaskOptions, type WatchTaskOptions, adaptSandboxInput, availabilityBuckets, availabilityStats, classifyObservation, createNexra, defaultProbeInterval, defaultProbeTimeout, encodeAdminUserCursor, encodeUsageFilterCursor, encodeUsageKeysetCursor, encodeUsageSummaryCursor, isMoneyString, isTerminalTaskStatus, modelInputDefaults, modelInputUi, modelUploadRegion, moneyFromUnits, moneyToUnits, multiplyMoney, normalizeModelParameterSchema, orderedSchemaProperties, parseAdminUserCursor, parseUsageFilterCursor, parseUsageKeysetCursor, parseUsageSummaryCursor, probeCostExceeds, rateProbeUsage, sandboxIdentity, sandboxInputSchema, sandboxModelModes, sandboxObject, sandboxOperations, sandboxProperties, sandboxSupports, sandboxVoiceKey, taskReceipt, taskResult, uploadedMediaInput, uploadedMediaUrl, validateAdminUserApiKeyUpdate, validateAdminUserListQuery, validateAdminUserUpdate, validateAdminWalletRechargeInput, validateUsageAnomaliesQuery, validateUsageAnomalySummaryQuery, validateUsageDetailsQuery, validateUsageFilterOptionsQuery, validateUsageFilters, validateUsageSummaryQuery, verifyWebhook };

package/dist/index.js

@@ -4,12 +4,16 @@ import {
   NexraApiError,
   NexraTaskError,
   NexraWaitTimeoutError,
+  applyMediaGeometry,
+  decodeMediaGeometry,
+  encodeMediaGeometry,
   getModelSpec,
   jsonBody,
   listModelSpecs,
+  projectMediaGeometry,
   queryString,
   sleep
-} from "./chunk-AV3GN4TV.js";
+} from "./chunk-BQQU5NJ7.js";
 import {
   ceilDecimal,
   multiplyDecimal
@@ -926,6 +930,222 @@ function probeCostExceeds(actual, limit) {
   return units(actual) > units(limit);
 }
 
+// ../contracts/src/sandbox.ts
+var SANDBOX_OPERATIONS = [
+  { id: "text-to-speech", modality: "audio", label: "\u8BED\u97F3\u5408\u6210" },
+  { id: "text-to-music", modality: "audio", label: "\u97F3\u4E50\u751F\u6210" },
+  { id: "multimodal-to-video", modality: "video", label: "\u5168\u80FD\u53C2\u8003\u751F" },
+  { id: "text-to-video", modality: "video", label: "\u53C2\u8003\u751F\u6210\u89C6\u9891" },
+  { id: "image-to-video", modality: "video", label: "\u9996\u5C3E\u5E27\u751F\u6210\u89C6\u9891" },
+  { id: "text-to-image", modality: "image", label: "\u6587\u751F\u56FE" },
+  { id: "image-to-image", modality: "image", label: "\u56FE\u751F\u56FE" },
+  { id: "text-to-text", modality: "language", label: "\u5BF9\u8BDD\u751F\u6210" }
+];
+var sandboxObject = (v) => v && typeof v === "object" && !Array.isArray(v) ? v : {};
+var obj = sandboxObject;
+var array = (v) => Array.isArray(v) ? v : [];
+function sandboxIdentity(slug) {
+  return slug === "google/veo-3-1-fast" ? "google/veo-3-1-fast-generate-001" : slug;
+}
+function sandboxModelModes(model) {
+  if (model.modality === "language") return ["text-to-text"];
+  if (model.modality === "audio") return model.capabilities.inputModes.includes("text-to-speech") ? ["text-to-speech"] : ["elevenlabs/music_v2", "minimax/music-2.6"].includes(model.slug) ? ["text-to-music"] : [];
+  if (model.slug === "heygen/heygen-avatar-video" || model.slug === "yadan/minimax-h3-local") return [];
+  const modes = model.capabilities.inputModes.filter((mode) => ["text-to-image", "image-to-image", "text-to-video", "image-to-video"].includes(mode)).filter((mode) => !(model.slug === "pixverse/baidu-vod-pc1" && mode === "image-to-video"));
+  if (model.capabilities.inputModes.includes("audio-to-video") && model.capabilities.inputModes.includes("video-to-video")) modes.push("multimodal-to-video");
+  return modes;
+}
+function sandboxOperations(models) {
+  return SANDBOX_OPERATIONS.filter((op) => new Set(models.filter((m) => m.modality === op.modality && sandboxModelModes(m).includes(op.id)).map((m) => sandboxIdentity(m.slug))).size >= 2);
+}
+function sandboxProperties(schema) {
+  const root = obj(schema.inputSchema.properties);
+  return { root, parameters: obj(obj(root.parameters).properties) };
+}
+function values(field) {
+  return Array.isArray(field.enum) ? field.enum : [];
+}
+function normalized(value) {
+  return String(value).toLowerCase();
+}
+function choose(field, requested, numeric = false) {
+  const options = values(field);
+  if (options.length) {
+    const exact = options.find((v) => normalized(v) === normalized(requested));
+    if (exact !== void 0) return exact;
+    if (numeric) {
+      const n = parseFloat(String(requested));
+      const ranked = options.filter((v) => Number.isFinite(parseFloat(String(v)))).sort((a, b) => Math.abs(parseFloat(String(a)) - n) - Math.abs(parseFloat(String(b)) - n));
+      if (ranked.length && Number.isFinite(n)) return ranked[0];
+    }
+    throw new Error(`\u4E0D\u652F\u6301 ${String(requested)}`);
+  }
+  const branches = array(field.anyOf).map(obj);
+  const range = branches.find((b) => b.type === "integer" || typeof b.minimum === "number") ?? field;
+  if (numeric) {
+    const n = Number(requested);
+    if (!Number.isFinite(n)) throw new Error("\u9700\u8981\u6709\u6548\u6570\u503C");
+    const bounded = Math.min(Number(range.maximum ?? n), Math.max(Number(range.minimum ?? n), n));
+    return range.type === "integer" || field.type === "integer" ? Math.round(bounded) : bounded;
+  }
+  return requested;
+}
+function urls(value) {
+  return array(value).map((v) => typeof v === "string" ? v : String(obj(v).url ?? "")).filter(Boolean);
+}
+function mediaRoles(schema) {
+  const { root } = sandboxProperties(schema);
+  if (root.content) return array(obj(obj(root.content).items).oneOf).flatMap((v) => array(obj(obj(obj(v).properties).role).enum)).filter((v) => typeof v === "string");
+  return array(obj(obj(root.images)["x-ui"]).roles).filter((v) => typeof v === "string");
+}
+function sandboxSupports(schema, feature) {
+  const { root } = sandboxProperties(schema);
+  if (feature === "last_frame") return schema.model !== "yadan/minimax-h3-local" && mediaRoles(schema).includes("last_frame");
+  if (feature === "reference_images") return mediaRoles(schema).includes("reference_image") || schema.model === "pixverse/baidu-vod-pc1";
+  if (feature === "videos") return mediaRoles(schema).includes("reference_video") || array(obj(obj(root.videos)["x-ui"]).roles).includes("reference_video");
+  if (feature === "audios") return mediaRoles(schema).includes("reference_audio") || !!root.audios && array(obj(obj(root.audios)["x-ui"]).accept).includes("url");
+  return false;
+}
+function sandboxVoiceKey(model) {
+  return `voice:${model}`;
+}
+function adaptSandboxInput(schema, mode, input) {
+  const { root, parameters } = sandboxProperties(schema);
+  const nested = !!root.input && !!root.parameters;
+  const fields = nested ? parameters : root;
+  const body = {};
+  const settings = nested ? {} : body;
+  for (const key of array(schema.inputSchema.required)) if (typeof key === "string" && obj(root[key]).default !== void 0) body[key] = obj(root[key]).default;
+  if (root.model) body.model = String(schema.defaults?.model ?? schema.model.split("/").at(-1));
+  const prompt = typeof input.prompt === "string" ? input.prompt.trim() : "";
+  if (!prompt) throw new Error("\u8BF7\u586B\u5199\u63D0\u793A\u8BCD\u6216\u6717\u8BFB\u6587\u672C");
+  if (nested) body.input = { messages: [{ role: "user", content: [{ text: prompt }, ...urls(input.images).map((image) => ({ image }))] }] };
+  else if (root.content) body.content = [{ type: "text", text: prompt }];
+  else body[root.prompt ? "prompt" : root.texts ? "texts" : "text"] = prompt;
+  if (schema.model === "yadan/minimax-h3-local" && !["first_frame", "reference_images", "videos", "audios"].some((key) => urls(input[key]).length)) throw new Error("H3 Local \u5F53\u524D\u63A5\u5165\u9700\u8981\u81F3\u5C11\u4E00\u4EFD\u53C2\u8003\u7D20\u6750");
+  const imageInput = urls(input.images);
+  const first = urls(input.first_frame);
+  if (mode === "image-to-image" && !imageInput.length) throw new Error("\u56FE\u751F\u56FE\u9700\u8981\u8F93\u5165\u56FE\u7247");
+  if (mode === "image-to-video" && first.length !== 1) throw new Error("\u9996\u5C3E\u5E27\u751F\u6210\u89C6\u9891\u9700\u8981\u4E00\u5F20\u9996\u5E27");
+  if (mode === "text-to-image" && imageInput.length) throw new Error("\u8BF7\u5207\u6362\u5230\u56FE\u751F\u56FE");
+  if (mode === "text-to-video" && first.length) throw new Error("\u8BF7\u5207\u6362\u5230\u9996\u5C3E\u5E27\u751F\u6210\u89C6\u9891");
+  if (!nested && mode === "image-to-image") {
+    if (root.imageUrl) {
+      if (imageInput.length > 1) throw new Error("\u6B64\u6A21\u578B\u53EA\u652F\u6301\u4E00\u5F20\u8F93\u5165\u56FE");
+      body.imageUrl = imageInput[0];
+    } else if (obj(root.image).type === "object") body.images = imageInput.map((url) => ({ url }));
+    else if (root.image) body.image = imageInput;
+    else if (root.images) body.images = imageInput;
+    else throw new Error("\u6A21\u578B\u6CA1\u6709\u53EF\u6620\u5C04\u7684\u56FE\u7247\u8F93\u5165");
+  }
+  const media = [];
+  for (const [key, role, type] of [["first_frame", "first_frame", "image_url"], ["last_frame", "last_frame", "image_url"], ["reference_images", "reference_image", "image_url"], ["videos", "reference_video", "video_url"], ["audios", "reference_audio", "audio_url"]]) {
+    const entries = urls(input[key]);
+    if (key !== "first_frame" && entries.length && !sandboxSupports(schema, key)) throw new Error(`\u6A21\u578B\u4E0D\u652F\u6301 ${key}`);
+    for (const url of entries) media.push({ key, role, type, url });
+  }
+  if (urls(input.last_frame).length && !first.length) throw new Error("\u5C3E\u5E27\u9700\u8981\u540C\u65F6\u63D0\u4F9B\u9996\u5E27");
+  if (first.length && (urls(input.reference_images).length || urls(input.videos).length || urls(input.audios).length)) throw new Error("\u9996\u5C3E\u5E27\u4E0E\u53C2\u8003\u7D20\u6750\u8BF7\u5206\u5F00\u8FD0\u884C");
+  if (root.content) body.content = [...array(body.content), ...media.map((m) => ({ type: m.type, [m.type]: { url: m.url }, role: m.role }))];
+  else for (const [key, type] of [["images", "image_url"], ["videos", "video_url"], ["audios", "audio_url"]]) {
+    const entries = media.filter((m) => m.type === type);
+    if (entries.length) body[key] = entries.map((m, i) => schema.model === "yadan/minimax-h3-local" ? { url: m.url } : schema.model === "pixverse/baidu-vod-pc1" ? { url: m.url, role: "subject", referenceName: `ref${i + 1}` } : { url: m.url, role: m.role });
+  }
+  if (schema.model === "pixverse/baidu-vod-pc1" && urls(input.reference_images).length) {
+    const names = urls(input.reference_images).map((_, i) => `@ref${i + 1}`);
+    if (!names.every((name) => prompt.includes(name))) throw new Error(`\u8BF7\u5728\u63D0\u793A\u8BCD\u4E2D\u5F15\u7528 ${names.join("\u3001")}`);
+  }
+  if (schema.model.startsWith("xai/grok-imagine-video")) body.mode = first.length ? "image-to-video" : urls(input.reference_images).length ? "reference-to-video" : "text-to-video";
+  const ratio = typeof input.aspect_ratio === "string" && input.aspect_ratio !== "default" ? input.aspect_ratio : void 0;
+  const resolution = typeof input.resolution === "string" && input.resolution !== "default" ? input.resolution : void 0;
+  const ratioKey = ["ratio", "aspect_ratio", "aspectRatio"].find((k) => fields[k]);
+  if (ratio && ratioKey && !(["kuaishou/baidu-vod-kling-v3", "pixverse/baidu-vod-p60", "bytedance/doubao-seedance-2-5-260628"].includes(schema.model) && first.length)) settings[ratioKey] = choose(obj(fields[ratioKey]), ratio);
+  if (first.length && schema.model === "bytedance/doubao-seedance-2-5-260628") settings.ratio = "adaptive";
+  if (resolution && fields.resolution) settings.resolution = choose(obj(fields.resolution), resolution);
+  if (fields.size && (ratio || resolution)) {
+    const [rw, rh] = (ratio ?? "1:1").split(":").map(Number);
+    if (!rw || !rh) throw new Error("\u65E0\u6548\u753B\u9762\u6BD4\u4F8B");
+    const edge = resolution ? parseFloat(resolution) * 1024 : 1024;
+    let w = Math.round(edge * Math.sqrt(rw / rh) / 16) * 16;
+    let h = Math.round(edge * Math.sqrt(rh / rw) / 16) * 16;
+    const max = schema.model.startsWith("openai/") ? 3840 : schema.model.includes("qwen-image-edit") || nested && mode === "image-to-image" ? 2048 : 4096;
+    if (Math.max(w, h) > max) {
+      const scale = max / Math.max(w, h);
+      w = Math.floor(w * scale / 16) * 16;
+      h = Math.floor(h * scale / 16) * 16;
+    }
+    settings.size = `${w}${nested ? "*" : "x"}${h}`;
+  }
+  if (input.duration !== void 0 && fields.duration) settings.duration = choose(obj(fields.duration), input.duration, true);
+  if (input.generate_audio !== void 0) {
+    const key = fields.generate_audio ? "generate_audio" : fields.with_audio ? "with_audio" : void 0;
+    if (!key) throw new Error("\u6A21\u578B\u4E0D\u652F\u6301\u63A7\u5236\u751F\u6210\u97F3\u9891");
+    settings[key] = input.generate_audio;
+  }
+  if (mode === "text-to-speech") {
+    const voice = input[sandboxVoiceKey(schema.model)] ?? obj(root.voice_id).default;
+    if (!voice) throw new Error("\u8BF7\u9009\u62E9\u6B64\u6A21\u578B\u7684\u97F3\u8272");
+    body.voice_id = voice;
+  }
+  if (mode === "text-to-music") {
+    body.instrumental = input.instrumental ?? true;
+    if (root.lyrics_optimizer && body.instrumental === false) body.lyrics_optimizer = true;
+  }
+  if (nested) body.parameters = settings;
+  return body;
+}
+function sandboxInputSchema(schemas, mode) {
+  const field = (title, type = "string", extra = {}) => ({ type, title, ...extra });
+  const properties = { prompt: field(mode === "text-to-speech" ? "\u6717\u8BFB\u6587\u672C" : "\u63D0\u793A\u8BCD", "string", { minLength: 1, "x-ui": { control: "textarea", order: 0 } }) };
+  const required = ["prompt"];
+  const mediaField = (title, maxItems) => field(title, "array", { items: { type: "object", properties: { url: { type: "string", minLength: 1 }, role: { type: "string" } }, required: ["url"] }, maxItems, "x-ui": { control: "media", accept: ["url"] } });
+  if (mode === "image-to-image") {
+    properties.images = mediaField("\u8F93\u5165\u56FE\u7247", 16);
+    required.push("images");
+    obj(properties.images).minItems = 1;
+  }
+  if (mode === "image-to-video") {
+    properties.first_frame = mediaField("\u9996\u5E27", 1);
+    required.push("first_frame");
+    obj(properties.first_frame).minItems = 1;
+  }
+  if (mode.endsWith("video")) {
+    for (const [key, title, max] of [["last_frame", "\u5C3E\u5E27", 1], ["reference_images", "\u53C2\u8003\u56FE\u7247", 9], ["videos", "\u53C2\u8003\u89C6\u9891", 3], ["audios", "\u53C2\u8003\u97F3\u9891", 3]]) {
+      if (key === "last_frame" && mode !== "image-to-video") continue;
+      if (key !== "last_frame" && mode === "image-to-video") continue;
+      if (new Set(schemas.map((s) => sandboxIdentity(s.model))).size >= 2 && schemas.every((s) => sandboxSupports(s, key))) properties[key] = mediaField(title, max);
+    }
+    properties.duration = field("\u76EE\u6807\u65F6\u957F\uFF08\u79D2\uFF09", "integer", { minimum: 1, maximum: 30 });
+  }
+  if (mode.endsWith("image") || mode.endsWith("video")) {
+    const fields = schemas.map((s) => {
+      const { root, parameters } = sandboxProperties(s);
+      return root.parameters ? parameters : root;
+    });
+    const ratios = ["1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "21:9"].filter((r) => fields.every((p) => {
+      const k = ["ratio", "aspect_ratio", "aspectRatio"].find((k2) => p[k2]);
+      return !k || !values(obj(p[k])).length || values(obj(p[k])).includes(r);
+    }));
+    properties.aspect_ratio = field("\u753B\u9762\u6BD4\u4F8B", "string", { enum: ["default", ...ratios], default: "default", "x-ui": { optionLabels: { default: "\u5404\u6A21\u578B\u9ED8\u8BA4" } } });
+    const resolutions = (mode.endsWith("image") ? ["1K", "2K", "4K"] : ["480p", "540p", "720p", "768p", "1080p", "2K", "4K"]).filter((r) => fields.every((p) => !p.resolution || !values(obj(p.resolution)).length || values(obj(p.resolution)).some((v) => normalized(v) === r.toLowerCase())));
+    properties.resolution = field("\u6E05\u6670\u5EA6", "string", { enum: ["default", ...resolutions], default: "default", "x-ui": { optionLabels: { default: "\u5404\u6A21\u578B\u9ED8\u8BA4" } } });
+    if (schemas.length >= 2 && fields.every((p) => p.generate_audio || p.with_audio)) properties.generate_audio = field("\u751F\u6210\u58F0\u97F3", "boolean");
+  }
+  if (mode === "text-to-speech") for (const s of schemas) {
+    const voice = obj(sandboxProperties(s).root.voice_id);
+    properties[sandboxVoiceKey(s.model)] = { ...voice, title: `${s.model} \xB7 \u97F3\u8272`, "x-ui": { ...obj(voice["x-ui"]), resourceModel: s.model } };
+    required.push(sandboxVoiceKey(s.model));
+  }
+  if (mode === "text-to-text") {
+    properties.system = field("\u7CFB\u7EDF\u63D0\u793A\u8BCD", "string", { "x-ui": { control: "textarea" } });
+    properties.messages = field("\u5BF9\u8BDD\u5386\u53F2\uFF08\u53EF\u9009\uFF09", "array", { items: { type: "object", properties: { role: { type: "string", enum: ["user", "assistant"] }, content: { type: "string" } }, required: ["role", "content"], additionalProperties: false }, "x-ui": { control: "json" } });
+  }
+  if (mode === "text-to-music") properties.instrumental = field("\u7EAF\u97F3\u4E50", "boolean", { default: true });
+  const defaults = {};
+  for (const [key, value] of Object.entries(properties)) if (obj(value).default !== void 0) defaults[key] = obj(value).default;
+  return { model: schemas.map((s) => s.model).join(","), version: 1, dialect: "https://json-schema.org/draft/2020-12/schema", inputSchema: { type: "object", properties, required, additionalProperties: false }, outputSchema: {}, uiSchema: {}, defaults, examples: [] };
+}
+
 // src/assets.ts
 var AssetsClient = class {
   constructor(transport) {
@@ -1020,11 +1240,11 @@ var ModelsClient = class {
 
 // src/input.ts
 async function normalizeTaskInput(input, assets, signal) {
-  const normalized = await normalizeValue(input, assets, signal, /* @__PURE__ */ new WeakSet());
-  if (!isPlainObject(normalized)) {
+  const normalized2 = await normalizeValue(input, assets, signal, /* @__PURE__ */ new WeakSet());
+  if (!isPlainObject(normalized2)) {
     throw new TypeError("Task input must be a JSON object");
   }
-  return normalized;
+  return normalized2;
 }
 async function normalizeValue(value, assets, signal, ancestors) {
   if (value === null || typeof value === "string" || typeof value === "boolean") {
@@ -1045,21 +1265,21 @@ async function normalizeValue(value, assets, signal, ancestors) {
   if (isAssetReference(value)) return { assetId: value.assetId };
   if (Array.isArray(value)) {
     assertNotCircular(value, ancestors);
-    const normalized = await Promise.all(
+    const normalized2 = await Promise.all(
       value.map((item) => normalizeValue(item, assets, signal, ancestors))
     );
     ancestors.delete(value);
-    return normalized;
+    return normalized2;
   }
   if (isPlainObject(value)) {
     assertNotCircular(value, ancestors);
-    const normalized = {};
+    const normalized2 = {};
     for (const [key, item] of Object.entries(value)) {
       if (item === void 0) continue;
-      normalized[key] = await normalizeValue(item, assets, signal, ancestors);
+      normalized2[key] = await normalizeValue(item, assets, signal, ancestors);
     }
     ancestors.delete(value);
-    return normalized;
+    return normalized2;
   }
   throw new TypeError(`Task input contains a non-serializable ${typeof value} value`);
 }
@@ -1137,7 +1357,9 @@ var TasksClient = class {
   transport;
   assets;
   async create(model, options) {
-    const input = await normalizeTaskInput(options.input, this.assets, options.signal);
+    const schema = getModelSpec(model)?.operations[0]?.inputSchema;
+    const mapped = schema && options.input && typeof options.input === "object" && !Array.isArray(options.input) ? applyMediaGeometry(schema, options.input) : options.input;
+    const input = await normalizeTaskInput(mapped, this.assets, options.signal);
     const body = {
       model,
       input,
@@ -1359,6 +1581,7 @@ export {
   NexraClient,
   NexraTaskError,
   NexraWaitTimeoutError,
+  SANDBOX_OPERATIONS,
   TASK_STATUSES,
   TOKEN_METRICS,
   TasksClient,
@@ -1371,16 +1594,20 @@ export {
   USAGE_RATING_STATUSES,
   USAGE_SOURCES,
   WALLET_MAX_BALANCE_UNITS,
+  adaptSandboxInput,
   allocateDiscountedPriceLines,
+  applyMediaGeometry,
   assessUsageEvidence,
   availabilityBuckets,
   availabilityStats,
   ceilDecimal,
   classifyObservation,
   createNexra,
+  decodeMediaGeometry,
   defaultProbeInterval,
   defaultProbeTimeout,
   encodeAdminUserCursor,
+  encodeMediaGeometry,
   encodeUsageFilterCursor,
   encodeUsageKeysetCursor,
   encodeUsageSummaryCursor,
@@ -1404,8 +1631,17 @@ export {
   parseUsageKeysetCursor,
   parseUsageSummaryCursor,
   probeCostExceeds,
+  projectMediaGeometry,
   queryString,
   rateProbeUsage,
+  sandboxIdentity,
+  sandboxInputSchema,
+  sandboxModelModes,
+  sandboxObject,
+  sandboxOperations,
+  sandboxProperties,
+  sandboxSupports,
+  sandboxVoiceKey,
   sleep,
   taskReceipt,
   taskResult,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@byte_fluffy/nexra-sdk",
-  "version": "0.1.0-alpha.4",
+  "version": "0.1.0-alpha.6",
   "type": "module",
   "sideEffects": false,
   "repository": {