Skip to content

Commit bd27966

Browse files
HavenDVgithub-actions[bot]
andauthored
feat: Updated OpenAPI spec (#182)
Co-authored-by: github-actions[bot] <dependabot@bot.com>
1 parent 07f69a1 commit bd27966

19 files changed

Lines changed: 1792 additions & 415 deletions

src/libs/Ideogram/Generated/Ideogram.DatasetsClient.TrainDatasetModel.g.cs

Lines changed: 0 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -501,55 +501,18 @@ partial void ProcessTrainDatasetModelResponseContent(
501501
/// Name for the trained model. Must be 5-30 characters, alphanumeric with spaces and hyphens allowed.<br/>
502502
/// Example: my-custom-model
503503
/// </param>
504-
/// <param name="trainingSteps">
505-
/// Number of training steps. Must be between 100 and 20000 and a multiple of 100. Defaults to 1000.<br/>
506-
/// Example: 1000
507-
/// </param>
508-
/// <param name="loraRank">
509-
/// LoRA rank for model training. Must be one of 64, 128, or 256. Defaults to 128. Note: lora_rank 256 requires num_chips &gt;= 64.<br/>
510-
/// Example: 64
511-
/// </param>
512-
/// <param name="numChips">
513-
/// Number of TPU chips to use. Allowed values depend on the base_model_version: V_3_1 supports 16, 32, or 64, V_4_0 supports 128.<br/>
514-
/// Example: 32
515-
/// </param>
516-
/// <param name="baseModelVersion">
517-
/// Base model version to train on. Defaults to V_3_1.<br/>
518-
/// Default Value: V_3_1<br/>
519-
/// Example: V_3_1
520-
/// </param>
521-
/// <param name="ema">
522-
/// Exponential moving average decay rate. Must be greater than 0.<br/>
523-
/// Example: 0.999F
524-
/// </param>
525-
/// <param name="learningRate">
526-
/// Learning rate for the optimizer. Must be greater than 0.<br/>
527-
/// Example: 0.0001F
528-
/// </param>
529504
/// <param name="requestOptions">Per-request overrides such as headers, query parameters, timeout, retries, and response buffering.</param>
530505
/// <param name="cancellationToken">The token to cancel the operation with</param>
531506
/// <exception cref="global::System.InvalidOperationException"></exception>
532507
public async global::System.Threading.Tasks.Task<global::Ideogram.TrainDatasetModelResponse> TrainDatasetModelAsync(
533508
string datasetId,
534509
string modelName,
535-
int? trainingSteps = default,
536-
int? loraRank = default,
537-
int? numChips = default,
538-
global::Ideogram.TrainDatasetModelRequestBaseModelVersion? baseModelVersion = default,
539-
double? ema = default,
540-
double? learningRate = default,
541510
global::Ideogram.AutoSDKRequestOptions? requestOptions = default,
542511
global::System.Threading.CancellationToken cancellationToken = default)
543512
{
544513
var __request = new global::Ideogram.TrainDatasetModelRequest
545514
{
546515
ModelName = modelName,
547-
TrainingSteps = trainingSteps,
548-
LoraRank = loraRank,
549-
NumChips = numChips,
550-
BaseModelVersion = baseModelVersion,
551-
Ema = ema,
552-
LearningRate = learningRate,
553516
};
554517

555518
return await TrainDatasetModelAsync(

src/libs/Ideogram/Generated/Ideogram.IDatasetsClient.TrainDatasetModel.g.cs

Lines changed: 0 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -28,43 +28,12 @@ public partial interface IDatasetsClient
2828
/// Name for the trained model. Must be 5-30 characters, alphanumeric with spaces and hyphens allowed.<br/>
2929
/// Example: my-custom-model
3030
/// </param>
31-
/// <param name="trainingSteps">
32-
/// Number of training steps. Must be between 100 and 20000 and a multiple of 100. Defaults to 1000.<br/>
33-
/// Example: 1000
34-
/// </param>
35-
/// <param name="loraRank">
36-
/// LoRA rank for model training. Must be one of 64, 128, or 256. Defaults to 128. Note: lora_rank 256 requires num_chips &gt;= 64.<br/>
37-
/// Example: 64
38-
/// </param>
39-
/// <param name="numChips">
40-
/// Number of TPU chips to use. Allowed values depend on the base_model_version: V_3_1 supports 16, 32, or 64, V_4_0 supports 128.<br/>
41-
/// Example: 32
42-
/// </param>
43-
/// <param name="baseModelVersion">
44-
/// Base model version to train on. Defaults to V_3_1.<br/>
45-
/// Default Value: V_3_1<br/>
46-
/// Example: V_3_1
47-
/// </param>
48-
/// <param name="ema">
49-
/// Exponential moving average decay rate. Must be greater than 0.<br/>
50-
/// Example: 0.999F
51-
/// </param>
52-
/// <param name="learningRate">
53-
/// Learning rate for the optimizer. Must be greater than 0.<br/>
54-
/// Example: 0.0001F
55-
/// </param>
5631
/// <param name="requestOptions">Per-request overrides such as headers, query parameters, timeout, retries, and response buffering.</param>
5732
/// <param name="cancellationToken">The token to cancel the operation with</param>
5833
/// <exception cref="global::System.InvalidOperationException"></exception>
5934
global::System.Threading.Tasks.Task<global::Ideogram.TrainDatasetModelResponse> TrainDatasetModelAsync(
6035
string datasetId,
6136
string modelName,
62-
int? trainingSteps = default,
63-
int? loraRank = default,
64-
int? numChips = default,
65-
global::Ideogram.TrainDatasetModelRequestBaseModelVersion? baseModelVersion = default,
66-
double? ema = default,
67-
double? learningRate = default,
6837
global::Ideogram.AutoSDKRequestOptions? requestOptions = default,
6938
global::System.Threading.CancellationToken cancellationToken = default);
7039
}
Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
#nullable enable
2+
3+
namespace Ideogram
4+
{
5+
public partial interface IModelsClient
6+
{
7+
/// <summary>
8+
/// Train a custom Ideogram v3 model<br/>
9+
/// Start training a custom Ideogram v3 model from a dataset using default hyperparameters. The dataset must contain at least 15 images and a maximum of 100 images.
10+
/// </summary>
11+
/// <param name="request"></param>
12+
/// <param name="requestOptions">Per-request overrides such as headers, query parameters, timeout, retries, and response buffering.</param>
13+
/// <param name="cancellationToken">The token to cancel the operation with</param>
14+
/// <exception cref="global::Ideogram.ApiException"></exception>
15+
global::System.Threading.Tasks.Task<global::Ideogram.TrainDatasetModelResponse> TrainModelV3Async(
16+
17+
global::Ideogram.TrainModelV3Request request,
18+
global::Ideogram.AutoSDKRequestOptions? requestOptions = default,
19+
global::System.Threading.CancellationToken cancellationToken = default);
20+
/// <summary>
21+
/// Train a custom Ideogram v3 model<br/>
22+
/// Start training a custom Ideogram v3 model from a dataset using default hyperparameters. The dataset must contain at least 15 images and a maximum of 100 images.
23+
/// </summary>
24+
/// <param name="datasetId">
25+
/// ID of the dataset to train the model from.<br/>
26+
/// Example: abc123
27+
/// </param>
28+
/// <param name="modelName">
29+
/// Name for the trained model. Must be 5-30 characters, alphanumeric with spaces and hyphens allowed.<br/>
30+
/// Example: my-custom-model
31+
/// </param>
32+
/// <param name="requestOptions">Per-request overrides such as headers, query parameters, timeout, retries, and response buffering.</param>
33+
/// <param name="cancellationToken">The token to cancel the operation with</param>
34+
/// <exception cref="global::System.InvalidOperationException"></exception>
35+
global::System.Threading.Tasks.Task<global::Ideogram.TrainDatasetModelResponse> TrainModelV3Async(
36+
string datasetId,
37+
string modelName,
38+
global::Ideogram.AutoSDKRequestOptions? requestOptions = default,
39+
global::System.Threading.CancellationToken cancellationToken = default);
40+
}
41+
}
Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
#nullable enable
2+
3+
namespace Ideogram
4+
{
5+
public partial interface IModelsClient
6+
{
7+
/// <summary>
8+
/// Train a custom Ideogram v3 model with advanced hyperparameters<br/>
9+
/// Start training a custom Ideogram v3 model from a dataset with caller-supplied hyperparameters (training steps, LoRA rank, EMA decay, learning rate). All hyperparameters are optional and fall back to defaults when omitted. The dataset must contain at least 15 images and a maximum of 100 images. Returns the model ID and training status.
10+
/// </summary>
11+
/// <param name="request"></param>
12+
/// <param name="requestOptions">Per-request overrides such as headers, query parameters, timeout, retries, and response buffering.</param>
13+
/// <param name="cancellationToken">The token to cancel the operation with</param>
14+
/// <exception cref="global::Ideogram.ApiException"></exception>
15+
global::System.Threading.Tasks.Task<global::Ideogram.TrainDatasetModelResponse> TrainModelV3AdvancedAsync(
16+
17+
global::Ideogram.TrainModelV3AdvancedRequest request,
18+
global::Ideogram.AutoSDKRequestOptions? requestOptions = default,
19+
global::System.Threading.CancellationToken cancellationToken = default);
20+
/// <summary>
21+
/// Train a custom Ideogram v3 model with advanced hyperparameters<br/>
22+
/// Start training a custom Ideogram v3 model from a dataset with caller-supplied hyperparameters (training steps, LoRA rank, EMA decay, learning rate). All hyperparameters are optional and fall back to defaults when omitted. The dataset must contain at least 15 images and a maximum of 100 images. Returns the model ID and training status.
23+
/// </summary>
24+
/// <param name="datasetId">
25+
/// ID of the dataset to train the model from.<br/>
26+
/// Example: abc123
27+
/// </param>
28+
/// <param name="modelName">
29+
/// Name for the trained model. Must be 5-30 characters, alphanumeric with spaces and hyphens allowed.<br/>
30+
/// Example: my-custom-model
31+
/// </param>
32+
/// <param name="trainingSteps">
33+
/// Number of training steps. Must be between 100 and 10000 and a multiple of 100. Defaults to 1000.<br/>
34+
/// Example: 1000
35+
/// </param>
36+
/// <param name="loraRank">
37+
/// LoRA rank for model training. Must be one of 64 or 128. Defaults to 128. Higher rank increases model capacity at the cost of longer training and larger weights.<br/>
38+
/// Example: 64
39+
/// </param>
40+
/// <param name="ema">
41+
/// Exponential moving average decay rate for the model weights. Must be between 0 and 1 (exclusive). Typical values are 0.99-0.9999; higher values produce smoother weight averages but respond more slowly to training updates.<br/>
42+
/// Example: 0.999F
43+
/// </param>
44+
/// <param name="learningRate">
45+
/// Learning rate for the optimizer. Must be greater than 0. Typical values for LoRA fine-tuning are 1e-5 to 1e-4; larger values train faster but risk instability.<br/>
46+
/// Example: 0.0001F
47+
/// </param>
48+
/// <param name="requestOptions">Per-request overrides such as headers, query parameters, timeout, retries, and response buffering.</param>
49+
/// <param name="cancellationToken">The token to cancel the operation with</param>
50+
/// <exception cref="global::System.InvalidOperationException"></exception>
51+
global::System.Threading.Tasks.Task<global::Ideogram.TrainDatasetModelResponse> TrainModelV3AdvancedAsync(
52+
string datasetId,
53+
string modelName,
54+
int? trainingSteps = default,
55+
int? loraRank = default,
56+
double? ema = default,
57+
double? learningRate = default,
58+
global::Ideogram.AutoSDKRequestOptions? requestOptions = default,
59+
global::System.Threading.CancellationToken cancellationToken = default);
60+
}
61+
}

src/libs/Ideogram/Generated/Ideogram.JsonConverters.TrainDatasetModelRequestBaseModelVersion.g.cs

Lines changed: 0 additions & 53 deletions
This file was deleted.

src/libs/Ideogram/Generated/Ideogram.JsonConverters.TrainDatasetModelRequestBaseModelVersionNullable.g.cs

Lines changed: 0 additions & 60 deletions
This file was deleted.

src/libs/Ideogram/Generated/Ideogram.JsonSerializerContext.g.cs

Lines changed: 3 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -89,10 +89,6 @@ namespace Ideogram
8989

9090
typeof(global::Ideogram.JsonConverters.DatasetAssetFailureReasonNullableJsonConverter),
9191

92-
typeof(global::Ideogram.JsonConverters.TrainDatasetModelRequestBaseModelVersionJsonConverter),
93-
94-
typeof(global::Ideogram.JsonConverters.TrainDatasetModelRequestBaseModelVersionNullableJsonConverter),
95-
9692
typeof(global::Ideogram.JsonConverters.ModelStatusJsonConverter),
9793

9894
typeof(global::Ideogram.JsonConverters.ModelStatusNullableJsonConverter),
@@ -345,16 +341,17 @@ namespace Ideogram
345341
[global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Ideogram.UploadDatasetAssetsRequest))]
346342
[global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Ideogram.TrainDatasetModelResponse))]
347343
[global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Ideogram.TrainDatasetModelRequest))]
348-
[global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Ideogram.TrainDatasetModelRequestBaseModelVersion), TypeInfoPropertyName = "TrainDatasetModelRequestBaseModelVersion2")]
349-
[global::System.Text.Json.Serialization.JsonSerializable(typeof(double))]
350344
[global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Ideogram.ListModelsResponse))]
351345
[global::System.Text.Json.Serialization.JsonSerializable(typeof(global::System.Collections.Generic.IList<global::Ideogram.CustomModel>))]
352346
[global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Ideogram.CustomModel))]
353347
[global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Ideogram.ModelStatus), TypeInfoPropertyName = "ModelStatus2")]
354348
[global::System.Text.Json.Serialization.JsonSerializable(typeof(global::System.Collections.Generic.IList<global::Ideogram.TrainingRun>))]
355349
[global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Ideogram.TrainingRun))]
356350
[global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Ideogram.TrainingRunStatus), TypeInfoPropertyName = "TrainingRunStatus2")]
351+
[global::System.Text.Json.Serialization.JsonSerializable(typeof(double))]
357352
[global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Ideogram.GetModelResponse))]
353+
[global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Ideogram.TrainModelV3Request))]
354+
[global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Ideogram.TrainModelV3AdvancedRequest))]
358355
[global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Ideogram.ColorPaletteWithPresetName))]
359356
[global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Ideogram.ColorPaletteWithMembers))]
360357
[global::System.Text.Json.Serialization.JsonSerializable(typeof(global::Ideogram.ColorPalettePresetName), TypeInfoPropertyName = "ColorPalettePresetName2")]

0 commit comments

Comments
 (0)