跳到主要內容

已不再支援此瀏覽器。

請升級至 Microsoft Edge,以利用最新功能、安全性更新和技術支援。

下載 Microsoft Edge Internet Explorer 和 Microsoft Edge 的詳細資訊
microsoft-foundry.rest.security.o-auth2-auth

Sampling

Generate completions

POST /fine_tuning/sessions/{sessionId}/sample

Generate one or more completions from the specified sampler checkpoint. The sampler-weights save request must have completed before sampling. Poll the returned request identifier for the result.

標頭參數

Foundry-Features enum 必要

A feature flag opt-in required when using preview operations or modifying persisted preview resources.

FineTuningSessions=V1Preview

路徑參數

sessionId string 必要

Identifier of the fine-tuning session containing the sampler checkpoint.

查詢參數

checkpoint_id string 必要

Identifier of the completed sampler checkpoint to use for generation.

api-version string 必要

The API version to use for this operation.

要求本文

Prompt and generation parameters for the requested completions.

Content-Type: application/json
num_samples integer

Number of independent completions to generate. If omitted, the service defaults to 1.

prompt SessionFineTuning.FineTuningModelInput 必要

Full model input as an ordered sequence of token-ID and image chunks.

chunks SessionFineTuning.FineTuningInputChunk[] 必要

Chunks forming the complete model input. At most 64 image chunks are allowed per example; the service enforces this limit at runtime.

sampling_params SessionFineTuning.FineTuningSamplingParams 必要

Token-generation sampling parameters.

max_tokens integer 必要

Maximum number of tokens to generate. Must be positive.

temperature number

Softmax temperature. If omitted, the service defaults to 1.0.

top_p number

Nucleus (top-p) probability mass. If omitted, the service defaults to 1.0.

top_k integer

Top-k candidates. If omitted, the service defaults to -1. A value of -1 disables top-k filtering.

seed integer

RNG seed for reproducible samples. If omitted, the service chooses a random seed.

stop_criteria SessionFineTuning.FineTuningStopCriteria

Stop criteria for generation — either a list of token IDs or a list of strings, but never both.

stop_token_ids integer[]

Stop when any of these token IDs is produced.

stop_strings string[]

Stop when any of these strings appears in the output.

response_format object | null

Optional structured-output format passed to the sampling provider.

sampling_session_id string

Sampling session identifier from a prior sampler-weights save request.

seq_id integer

Training step index; must match the seq_id used when saving sampler weights.

prompt_logprobs boolean

Whether to return prompt-token log-probabilities in the overall sample result. If omitted, the service defaults to false.

topk_prompt_logprobs integer

Number of top-k log-probabilities per prompt token. If omitted, the service defaults to 0. Zero disables this output; maximum 20.

回覆

The request has succeeded.

主體

Content-Type: application/json
request_id string 必要

Request identifier to pass to the session's request-status endpoint.

status enum 必要

Indicates that the request has not yet completed.

pending

Client error

標題

x-ms-error-code string

String error code indicating what went wrong.

主體

Content-Type: application/json
error OpenAI.Error 必要
code string | null 必要
message string 必要
param string | null
type string
misalignment OpenAI.MisalignmentErrorDetailsResource
review_target string | null
error_type string | enum
以下任何一項:
string
enum
potentially_unintended_data_transferpotentially_unintended_data_accesspotentially_unintended_destructive_activityother
detailed_explanation string

The public explanation for this block.

steer OpenAI._MisalignmentSteer
message string 必要

The public continuation instruction.

details OpenAI.Error[]

Additional errors that contributed to this failure.

additionalInfo object

Additional structured information about the failure.

debugInfo object

Diagnostic information supplied by the service for troubleshooting.

Server error

標題

x-ms-error-code string

String error code indicating what went wrong.

主體

Content-Type: application/json
error OpenAI.Error 必要
code string | null 必要
message string 必要
param string | null
type string
misalignment OpenAI.MisalignmentErrorDetailsResource
review_target string | null
error_type string | enum
以下任何一項:
string
enum
potentially_unintended_data_transferpotentially_unintended_data_accesspotentially_unintended_destructive_activityother
detailed_explanation string

The public explanation for this block.

steer OpenAI._MisalignmentSteer
message string 必要

The public continuation instruction.

details OpenAI.Error[]

Additional errors that contributed to this failure.

additionalInfo object

Additional structured information about the failure.

debugInfo object

Diagnostic information supplied by the service for troubleshooting.

Request

POST /fine_tuning/sessions/{sessionId}/sample HTTP/1.1

回應

Status: 200
Content-Type: application/json
Status: 4XX
Content-Type: application/json
Status: 5XX
Content-Type: application/json
zh-tw
您的隱私權選擇
  • AI 免責聲明
  • 舊版本
  • 部落格
  • 參與
  • 隱私權
  • 消費者健康隱私
  • 使用規定
  • 商標
  • © Microsoft 2026